EVT_WDF_WMI_INSTANCE_SET_ITEM funzione di callback (wdfwmi.h)

Articolo
03/05/2024

[Si applica solo a KMDF]

La funzione di callback EvtWmiInstanceSetItem di un driver 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

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

[in] InBuffer

Puntatore al buffer di input.

Valore restituito

La funzione di callback EvtWmiInstanceSetItem 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 EvtWmiInstanceSetItem , 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 EvtWmiInstanceSetItem 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 EvtWmiInstanceSetItem , vedere Supporto di WMI nei driver Framework-Based.