EVT_WDF_WMI_INSTANCE_SET_INSTANCE Rückruffunktion (wdfwmi.h)

Artikel
02/27/2024

[Gilt nur für KMDF]

Die EvtWmiInstanceSetInstance-Rückruffunktion eines Treibers legt alle instance Daten eines WMI-Datenanbieters auf Werte fest, die ein WMI-Client bereitstellt.

Syntax

EVT_WDF_WMI_INSTANCE_SET_INSTANCE EvtWdfWmiInstanceSetInstance;

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

Parameter

[in] WmiInstance

Ein Handle für ein WMI-instance-Objekt.

[in] InBufferSize

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

[in] InBuffer

Ein Zeiger auf den Eingabepuffer.

Rückgabewert

Die Rückruffunktion EvtWmiInstanceSetInstance 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) gleich FALSE ist. 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.

Hinweise

Um eine EvtWmiInstanceSetInstance-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 EvtWmiInstanceSetInstance-Rückruffunktion dynamisch sind und für andere Rückruffunktionen freigegeben werden, kann Ihr Treiber die Warte- oder Drehsperren des Frameworks verwenden, um den Zugriff auf die Daten zu synchronisieren.

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