Freigeben über


PFNKSFILTERPROCESS-Rückruffunktion (ks.h)

Die AVStrMiniFilterProcess-Routine eines AVStream-Minitreibers wird aufgerufen, wenn der Filter Frames verarbeiten soll. Es wird verwendet, um die filterzentrierte Verarbeitung auszuführen.

Syntax

PFNKSFILTERPROCESS Pfnksfilterprocess;

NTSTATUS Pfnksfilterprocess(
  [in] PKSFILTER Filter,
       PKSPROCESSPIN_INDEXENTRY Index
)
{...}

Parameter

[in] Filter

Zeiger auf die KSFILTER-Struktur , die Frames verarbeiten muss.

Index

Zeiger auf ein Array von KSPROCESSPIN_INDEXENTRY Strukturen, die AVStream nach Pin-ID anordnet.

Rückgabewert

Geben Sie STATUS_SUCCESS zurück, um die Verarbeitung fortzusetzen. Geben Sie STATUS_PENDING zurück, um die Verarbeitung bis zum nächsten auslösenden Ereignis zu beenden. Der Minidriver gibt möglicherweise einen Fehlercode zurück, dieser wird jedoch wie für STATUS_PENDING beschrieben behandelt.

Hinweise

Der Minidriver gibt die Adresse dieser Routine im Prozesselement der KSFILTER_DISPATCH-Struktur an.

Die Routine wird entweder bei IRQL = DISPATCH_LEVEL oder PASSIVE_LEVEL aufgerufen, je nachdem, welche Einstellung im Filterdeskriptor angegeben ist. Filterdeskriptoren, die KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSING angeben, können ihren Prozessrückruf bei DISPATCH_LEVEL; Filterdeskriptoren, die dieses Flag nicht angeben, erhalten ihren Prozessrückruf bei PASSIVE_LEVEL.

Weitere Informationen finden Sie unter Filterzentrierte Verarbeitung und Neustarten der Verarbeitung in AVStream.

Diese Routine ist optional.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows XP und höheren Betriebssystemen sowie DirectX 8.0 und höher DirectX-Versionen.
Zielplattform Desktop
Kopfzeile ks.h (ks.h einschließen)
IRQL (Siehe Abschnitt "Hinweise")

Weitere Informationen

KSFILTER_DISPATCH

KSPROCESSPIN_INDEXENTRY