EVT_WDF_WMI_INSTANCE_SET_ITEM funzione di callback (wdfwmi.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

La evtWmiInstanceSetItem di un driver funzione di callback imposta un singolo elemento dei dati dell'istanza di un provider di dati WMI su un valore fornito da un client WMI.

Sintassi

EVT_WDF_WMI_INSTANCE_SET_ITEM EvtWdfWmiInstanceSetItem;

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

Parametri

[in] WmiInstance

Handle per un oggetto istanza WMI.

[in] DataItemId

Valore che identifica un elemento di dati per un'istanza del provider. Questo valore corrisponde al valore WmiDataId specificato nel file MOF del provider.

[in] InBufferSize

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

[in] InBuffer

Puntatore al buffer di input.

Valore restituito

L'EvtWmiInstanceSetItem funzione di callback 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) è 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.

Osservazioni

Per registrare un EvtWmiInstanceSetItem funzione di callback, 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 l'una con l'altra o con qualsiasi altra funzione di callback degli eventi del driver. Se un EvtWmiInstanceSetItem dati della funzione di callback è dinamico e condiviso con altre funzioni di callback, il driver può usare i blocchi di attesa del framework o i blocchi di selezione per sincronizzare l'accesso ai dati.

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