KsPinAcquireControl function (ks.h)

Article
02/22/2024

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