IoWMIWriteEvent-Funktion (wdm.h)

  • Artikel

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
STATUS_SUCCESS
 Gibt an, dass WMI das Ereignis erfolgreich für die Übermittlung an die WMI-Komponenten im Benutzermodus in die Warteschlange gestellt hat.
STATUS_UNSUCCESSFUL
 Gibt an, dass WMI-Dienste nicht verfügbar sind.
STATUS_BUFFER_OVERFLOW
 Gibt an, dass das angegebene Ereigniselement die maximal zulässige Größe überschreitet.
STATUS_INSUFFICIENT_RESOURCES
 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")

Weitere Informationen

IoWmiDeviceObjectToProviderId

WNODE_EVENT_ITEM