KsFilterGenerateEvents-Funktion (ks.h)
Die KsFilterGenerateEvents--Funktion generiert Ereignisse eines angegebenen Typs, die in Filter-Ereignisliste vorhanden sind.
Syntax
void KsFilterGenerateEvents(
[in] PKSFILTER Filter,
[in, optional] const GUID *EventSet,
[in] ULONG EventId,
[in] ULONG DataSize,
[in] PVOID Data,
[in, optional] PFNKSGENERATEEVENTCALLBACK CallBack,
[in, optional] PVOID CallBackContext
);
Parameter
[in] Filter
Ein Zeiger auf eine KSFILTER- Struktur, auf der Ereignisse generiert werden sollen.
[in, optional] EventSet
Ein Zeiger auf die EREIGNISsatz-GUID, um zu bestimmen, welche Ereignisse generiert werden sollen. Wenn dieser Parameter NULL-ist, wird die EREIGNISsatz-GUID nicht zum Ermitteln übereinstimmender Ereignisse berücksichtigt.
[in] EventId
Die Ereignis-ID, die übereinstimmen soll, um zu bestimmen, welche Ereignisse generiert werden sollen.
[in] DataSize
Die Größe Daten- in Byte.
[in] Data
Ein Zeiger auf einen Datenpuffer. Geben Sie an, ob ein Datenereignis generiert wird.
[in, optional] CallBack
Ein Zeiger auf eine vom Aufrufer angegebene Funktion, die aufgerufen wird, um zu bestimmen, ob ein bestimmtes Ereignis generiert werden soll. Wenn dies NULL-ist, wird keine Rückrufüberprüfung ausgeführt, um zu bestimmen, ob ein Ereignis generiert werden soll (nur *EventSet *und EventId verwendet werden). Weitere Informationen finden Sie im Abschnitt "Hinweise" weiter unten.
[in, optional] CallBackContext
Ein optionaler Zeiger auf einen vom Aufrufer angegebenen Kontext, der an die Rückruffunktion übergeben wird, CallBack-. Weitere Informationen finden Sie im Abschnitt "Hinweise" weiter unten.
Rückgabewert
Nichts
Bemerkungen
Beim Aufrufen dieser Funktion muss ein Minidriver Data und CallBackContext- in einem gesperrten, nicht seitenfähigen Datensegment platzieren. Beachten Sie außerdem, dass die CallBack- bei DISPATCH_LEVEL erfolgt. Die Rückruffunktion muss sich in einem gesperrten Segment befinden und muss für die Ausführung unter IRQL = DISPATCH_LEVEL vorbereitet sein. Beachten Sie, dass es in DX8 ein zusätzliches Problem gibt, nur: EventSet- muss sich in einem gesperrten Datensegment befinden.
Dies ist ein Inlinefunktionsaufruf KsGenerateEvents, der die erforderliche Typecasting durchführt. Minidriver sollten diese Version in der Regel aufrufen, anstatt KsGenerateEventsdirekt aufzurufen.
Ein Ereignis wird generiert, wenn die folgenden Bedingungen aufbewahrt werden:
Das Ereignis ist in Filterliste'Ereignisliste vorhanden und EventId entspricht der EREIGNIS-ID des Ereignisses.
EventSet- entspricht entweder der GUID des Ereignisses oder ist NULL-
CallBack- ist entweder NULL- oder autorisiert die Übereinstimmung.
CallBack- ist ein caller-specified callback, der für zusätzliche Übereinstimmungsermittlung verwendet wird. Es wird wie folgt prototypiert:
BOOLEAN CallBack (IN PVOID Context, IN PKSEVENT_ENTRY EventEntry);
AVStream übergibt den Inhalt des KsFilterGenerateEvents Parameter der Routine CallBackContext- im Context-Parameter dieses Rückrufs. EventEntry ist ein Zeiger auf eine KSEVENT_ENTRY Struktur, die das generierte Ereignis angibt. Die Rückruffunktion sollte TRUE- zurückgeben, wenn dieses Ereignis generiert werden soll.
Weitere Informationen finden Sie unter Ereignisbehandlung in AVStream- und KS-Ereignisse.
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) |
| Library | Ks.lib |
| IRQL- | <=DISPATCH_LEVEL (Siehe Abschnitt "Hinweise").) |