KsPinAcquireControl function (ks.h)

The KsPinAcquireControl function acquires the control mutex for the AVStream pin specified by Pin.

Syntax

void KsPinAcquireControl(
  [in] PKSPIN Pin
);

Parameters

[in] Pin

A pointer to the KSPIN for which to acquire the control mutex.

Return value

None

Remarks

The pin control mutex is the same mutex that is used by Pin's parent. This means that the mutex for Pin is also a filter control mutex. For more information, see Mutexes in AVStream.

KsPinAcquireControl is an inline call to KsAcquireControl with the appropriate typecasting. Minidrivers manipulating pins should call KsPinAcquireControl instead of calling KsAcquireControl directly.

Requirements

Requirement Value
Minimum supported client Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.
Target Platform Desktop
Header ks.h (include Ks.h)
IRQL PASSIVE_LEVEL

See also

KSPIN

KsAcquireControl

KsPinReleaseControl

KsReleaseControl