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 zu einem WMI-Instanzobjekt.

[in] InBufferSize

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

[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 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 Daten zu enthalten, die der Treiber erwartet, muss die Rückruffunktion STATUS_WMI_SET_FAILURE zurückgeben.

Bemerkungen

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 einer der anderen Ereignisrückruffunktionen des Treibers. Wenn die Daten einer EvtWmiInstanceSetInstance-Rückruffunktion dynamisch und für andere Rückruffunktionen freigegeben werden, kann Ihr Treiber die Wartesperren oder Drehsperren des Frameworks verwenden, um den Zugriff auf die Daten zu synchronisieren.

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

Anforderungen

   
Zielplattform Universell
KMDF-Mindestversion 1.0
Header wdfwmi.h (einschließen Wdf.h)
IRQL PASSIVE_LEVEL

Siehe auch

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetItem

EvtWmiProviderFunctionControl

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate