EVT_WDF_WMI_INSTANCE_SET_ITEM Rückruffunktion (wdfwmi.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

Die EvtWmiInstanceSetItem Rückruffunktion eines Treibers legt ein einzelnes Element der Instanzdaten eines WMI-Datenanbieters auf einen Wert fest, den ein WMI-Client bereitstellt.

Syntax

EVT_WDF_WMI_INSTANCE_SET_ITEM EvtWdfWmiInstanceSetItem;

NTSTATUS EvtWdfWmiInstanceSetItem(
  [in] WDFWMIINSTANCE WmiInstance,
  [in] ULONG DataItemId,
  [in] ULONG InBufferSize,
  [in] PVOID InBuffer
)
{...}

Parameter

[in] WmiInstance

Ein Handle für ein WMI-Instanzobjekt.

[in] DataItemId

Ein Wert, der ein Datenelement für eine Anbieterinstanz identifiziert. Dieser Wert entspricht dem WmiDataId- Wert, der in der MOF-Datei des Anbieters angegeben ist.

[in] InBufferSize

Die Größe des Eingabepuffers, auf den in Bytes InBuffer verweist.

[in] InBuffer

Ein Zeiger auf den Eingabepuffer.

Rückgabewert

Die EvtWmiInstanceSetItem- Rückruffunktion muss STATUS_SUCCESS zurückgeben, wenn der Vorgang erfolgreich ist. Andernfalls muss diese Funktion einen Statuswert zurückgeben, für den NT_SUCCESS(Status) FALSE-entspricht. Wenn der Eingabepuffer, auf den der InBuffer Parameter verweist, zu klein ist, um alle vom Treiber erwarteten Daten zu enthalten, muss die Rückruffunktion STATUS_WMI_SET_FAILURE zurückgeben.

Bemerkungen

Um eine EvtWmiInstanceSetItem- Rückruffunktion zu registrieren, muss Ihr Treiber die Adresse der Funktion in einer WDF_WMI_INSTANCE_CONFIG Struktur platzieren, bevor sie WdfWmiInstanceCreateaufruft.

Das Framework synchronisiert keine Aufrufe der WMI-Ereignisrückruffunktionen eines Treibers miteinander oder mit einer der anderen Ereignisrückruffunktionen des Treibers. Wenn ein EvtWmiInstanceSetItem Daten der Rückruffunktion dynamisch ist und mit anderen Rückruffunktionen geteilt wird, kann Ihr Treiber die wartenden Sperren oder Drehsperren des Frameworks verwenden, um den Zugriff auf die Daten zu synchronisieren.

Weitere Informationen zur EvtWmiInstanceSetItem Rückruffunktion finden Sie unter Unterstützen von WMI in Framework-Based Drivers.