KsFilterAcquireProcessingMutex function (ks.h)

The KsFilterAcquireProcessingMutex function acquires the processing mutex for a specified AVStream filter.

Syntax

void KsFilterAcquireProcessingMutex(
  [in] PKSFILTER Filter
);

Parameters

[in] Filter

A pointer to the KSFILTER structure representing the AVStream filter for which to acquire the processing mutex.

Return value

None

Remarks

AVStream holds the processing control mutex upon return from this routine. For more information, see Mutexes in AVStream.

A minidriver that must suspend processing for a long period of time should not use this mechanism. Instead, it should manipulate the processing control gate directly by using the KSGATEXxx functions.

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

KsFilterAttemptProcessing

KsFilterReleaseProcessingMutex

KsPinAcquireProcessingMutex

KsPinGetAndGate

KsPinReleaseProcessingMutex