EVT_WDF_WMI_INSTANCE_SET_INSTANCE funzione di callback (wdfwmi.h)

Articolo
02/29/2024

[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 su 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 istanza WMI.

[in] InBufferSize

Dimensione, in byte, del buffer di input a cui Punta InBuffer .

[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(status) è uguale 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 tra loro o con qualsiasi altra funzione di callback degli eventi del driver. Se i dati di una funzione di callback EvtWmiInstanceSetInstance sono dinamici e condivisi con altre funzioni di callback, il driver può usare i blocchi di attesa o i blocchi di rotazione del framework per sincronizzare l'accesso ai dati.

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