PFNKSFILTERPROCESS-Rückruffunktion (ks.h)

Artikel
07.02.2025

Die AVStrMiniFilterProcess Routine eines AVStream Minidrivers wird aufgerufen, wenn der Filter Frames verarbeiten soll. Es wird verwendet, um Filter-Centric Verarbeitungauszuführen.

Syntax

PFNKSFILTERPROCESS Pfnksfilterprocess;

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

Parameter

[in] Filter

Zeigen Sie 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

Gibt 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, dies wird jedoch wie für STATUS_PENDING beschrieben behandelt.

Bemerkungen

Der Minidriver gibt die Adresse dieser Routine im Process Member seiner KSFILTER_DISPATCH Struktur an.

Die Routine wird entweder bei IRQL = DISPATCH_LEVEL oder PASSIVE_LEVEL aufgerufen, abhängig von der Im Filterdeskriptor ausgedrückten Einstellung. Filterdeskriptoren, die KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSING angeben, haben möglicherweise ihren Prozessrückruf bei DISPATCH_LEVEL; Filterdeskriptoren, die dieses Flag nicht angeben, haben ihren Prozessrückruf bei PASSIVE_LEVEL.

Weitere Informationen finden Sie unter Filter-Centric Processing und Restarting Processing in AVStream.

Diese Routine ist optional.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen.
Zielplattform-	Desktop
Header-	ks.h (enthalten Ks.h)
IRQL-	(Siehe Abschnitt "Hinweise")

Siehe auch

KSFILTER_DISPATCH

KSPROCESSPIN_INDEXENTRY

Freigeben über