KsGenerateEvents-Funktion (ks.h)
Die KsGenerateEvents-Funktion generiert Ereignisse eines angegebenen Typs, die in der Ereignisliste von Object vorhanden sind.
Syntax
void KsGenerateEvents(
[in] PVOID Object,
[in, optional] const GUID *EventSet,
[in] ULONG EventId,
[in] ULONG DataSize,
[in, optional] PVOID Data,
[in, optional] PFNKSGENERATEEVENTCALLBACK CallBack,
[in, optional] PVOID CallBackContext
);
Parameter
[in] Object
Das Objekt, für das Ereignisse generiert werden sollen. Dies kann ein AVStream-Filter oder ein Anheftobjekt sein.
[in, optional] EventSet
Die Ereignis-GUID wird auf übereinstimmungen festgelegt, um zu bestimmen, welche Ereignisse generiert werden sollen. Wenn dieser Parameter NULL ist, wird die festgelegte GUID nicht berücksichtigt, um übereinstimmende Ereignisse zu bestimmen.
[in] EventId
Die abzugleichende Ereignis-ID, um zu bestimmen, welche Ereignisse generiert werden sollen.
[in] DataSize
Die Größe der Daten in Bytes, mit denen das Datenereignis generiert werden soll.
[in, optional] Data
Ein Zeiger auf einen Datenpuffer, der in die Ereignisbenachrichtigung eingeschlossen werden soll. Wenn der Treiber keine zusätzlichen Informationen über die Benachrichtigung übermitteln muss, legen Sie diesen optionalen Parameter auf NULL fest.
[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 durchgeführt, um zu bestimmen, ob ein Ereignis generiert werden soll (es werden nur *EventSet *und EventId verwendet).
[in, optional] CallBackContext
Ein Zeiger auf einen vom Aufrufer angegebenen Kontext, der an die Rückruffunktion CallBack übergeben wird.
Rückgabewert
Keine
Bemerkungen
Beim Aufrufen dieser Funktion muss ein Minidriver Data und CallBackContext in einem gesperrten, nicht ausstellbaren Datensegment platzieren. Beachten Sie außerdem, dass der Rückruf an DISPATCH_LEVEL erfolgt. Die Rückruffunktion muss sich in einem gesperrten Segment befindet und für die Ausführung unter IRQL = DISPATCH_LEVEL vorbereitet sein. Beachten Sie, dass nur in DX8 ein zusätzliches Problem vorliegt: EventSet muss sich in einem gesperrten Datensegment befinden.
Minidriver rufen diese Funktion in der Regel nicht direkt auf und verwenden stattdessen eine der Versionen, die eine entsprechende Umwandlung durchführt: KsFilterGenerateEvents oder KsPinGenerateEvents.
Ein Ereignis wird generiert, wenn es in der *Ereignisliste von *Object vorhanden ist und *EventId * mit der ID des Ereignisses übereinstimmt, EventSet entweder mit der festgelegten GUID des Ereignisses übereinstimmt oder NULL ist, und *CallBack * ist entweder NULL oder autorisiert die Übereinstimmung.
CallBack ist ein vom Aufrufer angegebenen Rückruf, der für die zusätzliche Übereinstimmungsermittlung verwendet wird. Es wird wie folgt prototypiert:
BOOLEAN CallBack (IN PVOID Context, IN PKSEVENT_ENTRY EventEntry);
AVStream übergibt den Inhalt des CallBackContext-Parameters der KsGenerateEvents-Routine 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-Ereignissen.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen sowie DirectX 8.0 und höher DirectX-Versionen. |
Zielplattform | Universell |
Header | ks.h (ks.h einschließen) |
Bibliothek | Ks.lib |
IRQL | <=DISPATCH_LEVEL |