KsPinRegisterIrpCompletionCallback-Funktion (ks.h)

Artikel
02/26/2024

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 Durchlauf um die Leitung abschließt und der Frame, der dem IRP zugeordnet ist, wiederverwendet oder eingestellt wird.

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 gibt die Adresse einer AVStrMiniPinIrpCompletion-Routine an, die aufgerufen werden soll, wenn ein IRP seine Durchquerung der Schaltung abgeschlossen hat und im Anlauf ist, wiederverwertet oder eingestellt zu werden.

Rückgabewert

Keine

Bemerkungen

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

Diese Funktion wird häufig von der Pinerstellungsverteilung aufgerufen. Siehe KSPIN_DISPATCH.

KsPinRegisterIrpCompletionCallback ist nur für IRP-Quellpins nützlich und wird in der Regel für Datenquellenpins verwendet. Bei einer Datenquellennadel wird der Rückruf durchgeführt, sobald die IRP wieder an den Pin abgeschlossen ist und im Anschluss wiederverwendet werden soll. Bei einer Datensenkennadel ist der Rückruf jedoch nicht direkt an die IRP-Vervollständigung gebunden. AVStream führt den Rückruf weiterhin durch, wenn der IRP zum Recycling zurückgibt. Diese Rückgabe erfolgt erst, wenn IRP alle Warteschlangen durchlaufen hat, die die darin enthaltenen Daten verwenden müssen. Informationen zu IRP-Quell-/Senkenpins im Vergleich zu Datenquellen-/Senken-Pins finden Sie in den DataFlow - und Communication-Membern der KSPIN_DESCRIPTOR-Struktur .

KsPinRegisterIrpCompletionCallback unterscheidet sich erheblich von KsPinRegisterFrameReturnCallback , da diese Routine die Pin nicht in einen neuen Modus versetzt; Es registriert einfach eine Rückrufroutine.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen.
Zielplattform	Universell
Header	ks.h (einschließlich Ks.h)
Bibliothek	Ks.lib
IRQL	PASSIVE_LEVEL