PFNKSSTREAMPOINTER-Rückruffunktion (ks.h)
AVStream ruft die AVStrMiniCancelCallback Routine eines Minidrivers auf, wenn das IRP, das einem geklonten Streamzeiger zugeordnet ist, abgebrochen wird. Diese Routine ist optional.
Syntax
PFNKSSTREAMPOINTER Pfnksstreampointer;
void Pfnksstreampointer(
[in] PKSSTREAM_POINTER StreamPointer
)
{...}
Parameter
[in] StreamPointer
Ein Zeiger auf den Klon KSSTREAM_POINTER, der dem abgebrochenen IRP zugeordnet ist. StreamPointer- wurde durch einen Aufruf von KsStreamPointerCloneerstellt.
Rückgabewert
Nichts
Bemerkungen
Der Minidriver gibt die Adresse dieser Routine im CancelCallback Parameter von KsStreamPointerClonean.
In AVStrMiniCancelCallback-sollte der Minidriver alle Verweise auf den Klonzeiger auf NULL-festlegen.
Darüber hinaus sollte der Minidriver alle Kontextinformationen entfernen, die mit dem Klonzeiger verbunden sind, und die Hardware über den Abbruch benachrichtigen.
Schließlich muss der Minidriver KsStreamPointerDelete- aufrufen, um den Klon und den damit verbundenen Kontext zu löschen. Wenn der Minidriver den Klon nicht löscht, behält das IRP eine Referenzanzahl bei und nicht vollständig, was möglicherweise dazu führt, dass verwandte Anwendungen abstürzen.
AVStrMiniCancelCallback- wird mit der Drehsperre der Warteschlange aufgerufen, daher an DISPATCH_LEVEL. Dementsprechend kann die Rückrufroutine keine Warteschlangenmanipulation oder Anruffunktionen ausführen, die einen Mutex abrufen.
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) |