EVT_WDF_WMI_INSTANCE_SET_INSTANCE funzione di callback (wdfwmi.h)

[Si applica solo a KMDF]

La funzione di callback EvtWmiInstanceSetInstance di un driver imposta tutti i dati dell'istanza di un provider di dati WMI sui valori forniti da un client WMI.

Sintassi

EVT_WDF_WMI_INSTANCE_SET_INSTANCE EvtWdfWmiInstanceSetInstance;

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

Parametri

[in] WmiInstance

Handle per un oggetto di istanza WMI.

[in] InBufferSize

Dimensioni, in byte, del buffer di input a cui InBuffer punta.

[in] InBuffer

Puntatore al buffer di input.

Valore restituito

La funzione di callback EvtWmiInstanceSetInstance deve restituire STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa funzione deve restituire un valore di stato per il quale NT_SUCCESS(stato) equivale a FALSE. Se il buffer di input a cui punta il parametro InBuffer è troppo piccolo per contenere tutti i dati previsti dal driver, la funzione di callback deve restituire STATUS_WMI_SET_FAILURE.

Commenti

Per registrare una funzione di callback EvtWmiInstanceSetInstance , il driver deve inserire l'indirizzo della funzione in una struttura WDF_WMI_INSTANCE_CONFIG prima di chiamare WdfWmiInstanceCreate.

Il framework non sincronizza le chiamate alle funzioni di callback degli eventi WMI di un driver con l'altra o con qualsiasi altra funzione di callback evento del driver. Se i dati della funzione di callback evtWmiInstanceSetInstance sono dinamici e condivisi con altre funzioni di callback, il driver può usare i blocchi di attesa del framework o i blocchi di spin per sincronizzare l'accesso ai dati.

Per altre informazioni sulla funzione di callback EvtWmiInstanceSetInstance , vedere Supporto di WMI nei driver di Framework-Based.

Requisiti

   
Piattaforma di destinazione Universale
Versione KMDF minima 1,0
Intestazione wdfwmi.h (include Wdf.h)
IRQL PASSIVE_LEVEL

Vedi anche

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetItem

EvtWmiProviderFunctionControl

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate