KsAcquireControl function (ks.h)

Article
02/22/2024

The KsAcquireControl function acquires the filter control mutex for Object.

Syntax

void KsAcquireControl(
  [in] PVOID Object
);

Parameters

[in] Object

A pointer to the object for which to acquire the filter control mutex. This should be a pointer to either a KSFILTER or a KSPIN, cast to PVOID.

Return value

None

Remarks

Minidrivers typically do not call this function directly, but instead call either KsFilterAcquireControl or KsPinAcquireControl. These functions provide the necessary typecasting to PVOID automatically.

For more information, see Mutexes in AVStream.

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	Universal
Header	ks.h (include Ks.h)
Library	Ks.lib
IRQL	PASSIVE_LEVEL