EVT_WDF_WMI_INSTANCE_SET_INSTANCE funzione di callback (wdfwmi.h)
[Si applica solo a KMDF]
La evtWmiInstanceSetInstance funzione di callback 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
Dimensioni, in byte, del buffer di input a cui InBuffer punta.
[in] InBuffer
Puntatore al buffer di input.
Valore restituito
La EvtWmiInstanceSetInstance 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 EvtWmiInstanceSetInstance 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 EvtWmiInstanceSetInstance 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 EvtWmiInstanceSetInstance, vedere Supporto di WMI in driver Framework-Based.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| intestazione | wdfwmi.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |