PCEVENT_ITEM-Struktur (portcls.h)
Die PCEVENT_ITEM-Struktur wird verwendet, um ein Ereignis zu beschreiben, das von einem bestimmten Filter, Pin oder Knoten unterstützt wird.
Syntax
typedef struct {
const GUID *Set;
ULONG Id;
ULONG Flags;
PCPFNEVENT_HANDLER Handler;
} PCEVENT_ITEM, *PPCEVENT_ITEM;
Member
Set
Gibt den Ereignissatz an. Dieser Member ist ein Zeiger auf eine GUID, die den Ereignissatz eindeutig identifiziert. Weitere Informationen finden Sie in der Liste der Ereignissatz-GUIDs unter Ereignissätze für Audiotreiber.
Id
Gibt die Ereignis-ID an. Dieses Element identifiziert ein Ereigniselement innerhalb des Ereignissatzes. Wenn der Ereignissatz N-Elemente enthält, sind gültige Ereignis-IDs ganze Zahlen im Bereich von 0 bis N-1.
Flags
Gibt den Typ des Ereignisses an. Dieser Member ist auf einen der folgenden Werte festgelegt:
PCEVENT_ITEM_FLAG_ENABLE
Gibt an, dass die Ereignisbenachrichtigung für diesen Ereignistyp aktiviert werden soll. Der Treiber sollte die Ereignisbenachrichtigung fortsetzen, bis der Client sie explizit deaktiviert.
PCEVENT_ITEM_FLAG_ONESHOT
Gibt an, dass die Ereignisbenachrichtigung nur für das nächste Auftreten dieses Ereignisses aktiviert werden soll. Der Client deaktiviert das Ereignis nicht (und sollte es auch nicht), sobald es aufgetreten ist.
PCEVENT_ITEM_FLAG_BASICSUPPORT
Wenn der Client dieses Flag angibt, gibt der Treiber STATUS_SUCCESS zurück, wenn er das Ereignis unterstützt, und einen Fehlercode, falls dies nicht der Fall ist.
Handler
Zeiger auf die Ereignishandlerroutine des Miniporttreibers. Dieser Member ist ein Funktionszeiger vom Typ PCPFNEVENT_HANDLER, der wie folgt definiert ist:
typedef NTSTATUS (*PCPFNEVENT_HANDLER)
(
IN PPCEVENT_REQUEST EventRequest
);
Beim Aufrufen der Handlerroutine übergibt der Aufrufer einen einzelnen Aufrufparameter, bei dem es sich um einen Zeiger auf eine vom Aufrufer zugewiesene PCEVENT_REQUEST-Struktur handelt.
Hinweise
Die PCEVENT_ITEM-Struktur gibt ein bestimmtes Ereigniselement in einer Automatisierungstabelle an. Die PCAUTOMATION_TABLE-Struktur verweist auf ein Array von PCEVENT_ITEM Strukturen.
In WDM-Audio ist das Ziel für eine Ereignisanforderung entweder eine Pin instance oder ein Knoten an einer Pin. Ein Filter instance kann nicht das Ziel einer Ereignisanforderung sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | portcls.h (portcls.h einschließen) |