KsPinRegisterIrpCompletionCallback-Funktion (ks.h)

Die KsPinRegisterIrpCompletionCallback-Funktion registriert eine minidriver-definierte Rückrufroutine für einen angegebenen Pin. AVStream ruft die minidriver-bereitgestellte Routine auf, wenn ein IRP einen Pass rund um den Schaltkreis abschließt, und der Frame, der dem IRP zugeordnet ist, wird bald wiederverwendet oder eingestellt.

Syntax

void KsPinRegisterIrpCompletionCallback(
  [in] PKSPIN                Pin,
  [in] PFNKSPINIRPCOMPLETION IrpCompletion
);

Parameter

[in] Pin

Ein Zeiger auf die KSPIN- Struktur, für die ein Abschlussrückruf registriert werden soll.

[in] IrpCompletion

Dieser Parameter stellt die Adresse eines AVStrMiniPinIrpCompletion- Routine bereit, die aufgerufen werden soll, wenn ein IRP seine Traversal des Schaltkreises abschließt und in der Lage ist, wiederverwendet oder zurückgezogen zu werden.

Rückgabewert

Nichts

Bemerkungen

KsPinRegisterIrpCompletionCallback-muss bei IRQL=PASSIVE_LEVEL aufgerufen werden, bevor der Pin in KSSTATE_ACQUIRE wechselt. Weitere Informationen zu Pinzuständen finden Sie unter KSSTATE.

Diese Funktion wird häufig aus der Pin-Erstellungsverteilung aufgerufen. Siehe KSPIN_DISPATCH.

KsPinRegisterIrpCompletionCallback ist nur für IRP-Quell-Pins nützlich und wird in der Regel für Datenquellen-Pins verwendet. Bei einer Datenquellen-Pin wird der Rückruf vorgenommen, sobald das IRP wieder an den Pin zurückgeführt wird und gerade wiederverwendet werden soll. Bei einem Datensenkennnadel ist der Rückruf jedoch nicht direkt an den IRP-Abschluss gebunden. AVStream führt den Rückruf immer noch aus, wenn der IRP zur Wiederverwendung zurückgibt. Diese Rückgabe tritt erst auf, wenn IRP alle Warteschlangen durchlaufen hat, die die darin enthaltenen Daten verwenden müssen. Informationen zu IRP-Quell-/Sink-Pins im Vergleich zu Datenquellen-/Sink-Pins finden Sie im DataFlow- und Communication Member der KSPIN_DESCRIPTOR Struktur.

KsPinRegisterIrpCompletionCallback unterscheidet sich erheblich von KsPinRegisterFrameReturnCallback- darin, dass diese Routine den Pin nicht in einen neuen Modus einfügt; sie registriert einfach eine Rückrufroutine.

Anforderungen

Siehe auch

AVStrMiniPinCreate

AVStrMiniPinIrpCompletion-

KSPIN-

KSPIN_DISPATCH

KSSTATE-

KsPinRegisterFrameReturnCallback-