EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL funzione di callback (wdfwmi.h)

Articolo
02/27/2024

[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.