EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL funzione di callback (wdfwmi.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

Il driver EvtWmiProviderFunctionControl funzione di callback abilita e disabilita il supporto del driver per la raccolta dei 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 per un oggetto provider WMI.

[in] Control

Valore WDF_WMI_PROVIDER_CONTROLtipizzato 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

L'EvtWmiProviderFunctionControl funzione di callback 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) è uguale a FALSE.

Osservazioni

Per registrare un EvtWmiProviderFunctionControl funzione di callback, il driver deve inserire l'indirizzo della funzione in una struttura WDF_WMI_PROVIDER_CONFIG prima di chiamare WdfWmiProviderCreate.

Se il driver imposta il flag di WdfWmiProviderExpensive nella Flags membro della struttura di WDF_WMI_PROVIDER_CONFIG di un provider di dati WMI e se il driver fornisce un EvtWmiProviderFunctionControl funzione di callback, il framework chiama la funzione di callback quando il driver deve abilitare o disabilitare la capacità di raccogliere dati WMI.

Invece di fornire un EvtWmiProviderFunctionControl funzione di callback, 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 in Framework-Based Driver.