Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die IoWMIWriteEvent Routine liefert ein bestimmtes Ereignis an die WMI-Komponenten für den Benutzermodus zur Benachrichtigung.
Syntax
NTSTATUS IoWMIWriteEvent(
[in, out] PVOID WnodeEventItem
);
Parameter
[in, out] WnodeEventItem
Zeiger auf eine WNODE_EVENT_ITEM Struktur, die an die WMI-Komponenten des Benutzermodus übermittelt werden soll, die eine Benachrichtigung über das Ereignis angefordert haben.
Rückgabewert
IoWMIWriteEvent gibt einen Statuscode aus der folgenden Liste zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Gibt an, dass WMI das Ereignis für die Übermittlung an die WMI-Komponenten im Benutzermodus erfolgreich 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 nicht genügend Ressourcen für WMI verfügbar waren, um das Ereignis zur Übermittlung in die Warteschlange zu stellen. |
Bemerkungen
Die WNODE_EVENT_ITEM Struktur, die vom Aufrufer zugewiesen und in WnodeEventItem- übergeben wird, muss aus einem nicht seitengebundenen Pool zugewiesen werden. Wenn IoWMIWriteEvent- STATUS_SUCCESS zurückgibt, wird der Speicher für das Ereigniselement automatisch vom System freigegeben. Wenn IoWMIWriteEvent einen anderen Wert als STATUS_SUCCESS zurückgibt, liegt es in der Verantwortung des Aufrufers, den Puffer freizuerlegen.
Treiber sollten nur IoWMIWriteEvent- für Ereignisse aufrufen, die für WMI aktiviert wurden. Dadurch wird sichergestellt, dass ein Ereignisverbraucher 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- bei 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 |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL (siehe Abschnitt "Hinweise") |