EVT_WDF_WMI_INSTANCE_SET_ITEM Rückruffunktion (wdfwmi.h)

Artikel
02/27/2024

[Gilt nur für KMDF]

Die EvtWmiInstanceSetItem-Rückruffunktion eines Treibers legt ein einzelnes Element der instance Daten 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-instance-Objekt.

[in] DataItemId

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

[in] InBufferSize

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

[in] InBuffer

Ein Zeiger auf den Eingabepuffer.

Rückgabewert

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

Hinweise

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

Das Framework synchronisiert keine Aufrufe der WMI-Ereignisrückruffunktionen eines Treibers miteinander oder mit anderen Ereignisrückruffunktionen des Treibers. Wenn die Daten einer EvtWmiInstanceSetItem-Rückruffunktion dynamisch sind und für andere Rückruffunktionen freigegeben werden, kann Ihr Treiber die Warte- oder Spinsperren des Frameworks verwenden, um den Zugriff auf die Daten zu synchronisieren.

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