KsAcquireControl function (ks.h)

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

See also

KSFILTER

KSPIN

KsFilterAcquireControl

KsPinAcquireControl

KsReleaseControl