PFNKSREMOVEEVENT-Rückruffunktion (ks.h)
Die AVStrMiniRemoveEvent-Routine eines AVStream-Minidrivers wird aufgerufen, wenn ein Client anfordert, aus der Benachrichtigungswarteschlange für ein Ereignis entfernt zu werden. Diese Routine ist optional.
Syntax
PFNKSREMOVEEVENT Pfnksremoveevent;
void Pfnksremoveevent(
[in] PFILE_OBJECT FileObject,
[in] _KSEVENT_ENTRY *EventEntry
)
{...}
Parameter
[in] FileObject
Zeiger auf das Dateiobjekt, für das das Ereignis entfernt werden soll.
[in] EventEntry
Zeiger auf eine von AVStream generierte KSEVENT_ENTRY-Struktur .
Rückgabewert
Keine
Bemerkungen
Der Minidriver gibt die Adresse dieser Routine im RemoveHandler-Member einer KSEVENT_ITEM-Struktur an. Die Ereignisbehandlung in AVStream beschreibt, wie der Minidriver diese Struktur für den Klassentreiber bereitstellt.
Wenn der Minidriver AVStrMiniRemoveEvent bereitstellt und entweder keinen AddHandler oder einen AddHandler angibt, der KsXxxAddEvent aufruft, muss das AVStrMiniRemoveEvent des Minidrivers RemoveEntryList mit einem Zeiger auf die LIST_ENTRY-Struktur in der KSEVENT_ENTRY-Struktur aufrufen:
&EventEntry -> ListEntry
Andernfalls sollte Ihr AVStrMiniRemoveEvent die im AddHandler ausgeführten Schritte umkehren.
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 | Desktop |
| Kopfzeile | ks.h (einschließlich Ks.h) |