EVT_WDF_WMI_INSTANCE_SET_INSTANCE Rückruffunktion (wdfwmi.h)

[Gilt nur für KMDF]

Die EvtWmiInstanceSetInstance Rückruffunktion eines Treibers legt alle Instanzdaten 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-Instanzobjekt.

[in] InBufferSize

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

[in] InBuffer

Ein Zeiger auf den Eingabepuffer.

Rückgabewert

Die EvtWmiInstanceSetInstance 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 EvtWmiInstanceSetInstance Rückruffunktion zu registrieren, muss der Treiber die Adresse der Funktion in einer WDF_WMI_INSTANCE_CONFIG Struktur platzieren, bevor WdfWmiInstanceCreateaufgerufen wird.

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

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

Anforderungen

Siehe auch

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetItem

EvtWmiProviderFunctionControl

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate