EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL funzione di callback (wdfwmi.h)
[Si applica solo a KMDF]
La funzione di callback EvtWmiProviderFunctionControl di un driver abilita e disabilita il supporto del driver per la raccolta di dati e l'invio di eventi per un provider di dati WMI specificato.
Sintassi
EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL EvtWdfWmiProviderFunctionControl;
NTSTATUS EvtWdfWmiProviderFunctionControl(
[in] WDFWMIPROVIDER WmiProvider,
[in] WDF_WMI_PROVIDER_CONTROL Control,
[in] BOOLEAN Enable
)
{...}
Parametri
[in] WmiProvider
Handle a un oggetto provider WMI.
[in] Control
Valore WDF_WMI_PROVIDER_CONTROL tipizzato che identifica una funzionalità che il driver deve abilitare o disabilitare.
[in] Enable
Valore booleano che, se TRUE, indica che il driver deve abilitare la funzionalità specificata da Control . Se FALSE, il driver deve disabilitare la funzionalità.
Valore restituito
La funzione callback EvtWmiProviderFunctionControl deve restituire STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS(stato) equivale a FALSE.
Commenti
Per registrare una funzione di callback EvtWmiProviderFunctionControl , il driver deve posizionare l'indirizzo della funzione in una struttura WDF_WMI_PROVIDER_CONFIG prima di chiama WdfWmiProviderCreate.
Se il driver imposta il flag WdfWmiProviderExpensive nel membro Flags della struttura di WDF_WMI_PROVIDER_CONFIG di un provider di dati WMI e se il driver fornisce una funzione di callback EvtWmiProviderFunctionControl , il framework chiama la funzione di callback quando il driver deve abilitare o disabilitare la possibilità di raccogliere dati WMI.
Anziché fornire una funzione di callback EvtWmiProviderFunctionControl , il driver può chiamare WdfWmiProviderIsEnabled per scoprire se deve abilitare o disabilitare la raccolta dei dati.
Per altre informazioni sulla funzione di callback EvtWmiProviderFunctionControl , vedere Supporto di WMI nei driver di Framework-Based.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Universale |
Versione KMDF minima | 1,0 |
Intestazione | wdfwmi.h (include Wdf.h) |
IRQL | PASSIVE_LEVEL |