IoWMIWriteEvent-Funktion (wdm.h)
Die IoWMIWriteEvent-Routine übermittelt ein bestimmtes Ereignis zur Benachrichtigung an die WMI-Komponenten im Benutzermodus.
Syntax
NTSTATUS IoWMIWriteEvent(
[in, out] PVOID WnodeEventItem
);
Parameter
[in, out] WnodeEventItem
Zeiger auf eine WNODE_EVENT_ITEM Struktur, die an die WMI-Komponenten im Benutzermodus übermittelt werden soll, die eine Benachrichtigung über das Ereignis angefordert haben.
Rückgabewert
IoWMIWriteEvent gibt einen status Code aus der folgenden Liste zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Gibt an, dass WMI das Ereignis erfolgreich für die Übermittlung an die WMI-Komponenten im Benutzermodus in die Warteschlange gestellt hat. |
|
Gibt an, dass WMI-Dienste nicht verfügbar sind. |
|
Gibt an, dass das angegebene Ereigniselement die maximal zulässige Größe überschreitet. |
|
Gibt an, dass für WMI nicht genügend Ressourcen zur Verfügung standen, um das Ereignis für die Übermittlung in die Warteschlange zu stellen. |
Hinweise
Die WNODE_EVENT_ITEM Struktur, die vom Aufrufer zugeordnet und in WnodeEventItem übergeben wird, muss aus einem nicht auslagerten Pool zugeordnet werden. Wenn IoWMIWriteEvent STATUS_SUCCESS zurückgibt, wird der Arbeitsspeicher für das Ereigniselement automatisch vom System freigegeben. Wenn IoWMIWriteEvent etwas anderes als STATUS_SUCCESS zurückgibt, liegt es in der Verantwortung des Aufrufers, den Puffer frei zu geben.
Treiber sollten IoWMIWriteEvent nur für Ereignisse aufrufen, die für WMI aktiviert wurden. Dadurch wird sichergestellt, dass ein Ereignisconsumer auf die Angabe dieses Ereignisses wartet.
Aufrufer dieser Routine müssen mit einer Ausnahme unter IRQL <= APC_LEVEL ausgeführt werden. Wenn das Flags-Element der WNODE_HEADER-Struktur WNODE_FLAG_TRACED_GUID enthält, kann IoWMIWriteEvent in jedem IRQL aufgerufen werden. (Die WNODE_HEADER-Struktur ist ein Element der WNODE_EVENT_ITEM-Struktur , auf die der WnodeEventItem-Parameter verweist.)
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 2000. |
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL (siehe Abschnitt "Hinweise") |