EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL función de devolución de llamada (wdfwmi.h)

Artículo
08/08/2023

[Solo se aplica a KMDF]

La función de devolución de llamada EvtWmiProviderFunctionControl de un controlador habilita y deshabilita la compatibilidad del controlador para recopilar datos y enviar eventos para un proveedor de datos WMI especificado.

Sintaxis

EVT_WDF_WMI_PROVIDER_FUNCTION_CONTROL EvtWdfWmiProviderFunctionControl;

NTSTATUS EvtWdfWmiProviderFunctionControl(
  [in] WDFWMIPROVIDER WmiProvider,
  [in] WDF_WMI_PROVIDER_CONTROL Control,
  [in] BOOLEAN Enable
)
{...}

Parámetros

[in] WmiProvider

Identificador de un objeto de proveedor WMI.

[in] Control

Valor de tipo WDF_WMI_PROVIDER_CONTROL que identifica una funcionalidad que el controlador debe habilitar o deshabilitar.

[in] Enable

Valor booleano que, si es TRUE, indica que el controlador debe habilitar la funcionalidad que especifica Control . Si es FALSE, el controlador debe deshabilitar la funcionalidad.

Valor devuelto

La función de devolución de llamada EvtWmiProviderFunctionControl debe devolver STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, debe devolver un valor de estado para el que NT_SUCCESS(status) es igual a FALSE.

Comentarios

Para registrar una función de devolución de llamada EvtWmiProviderFunctionControl , el controlador debe colocar la dirección de la función en una estructura de WDF_WMI_PROVIDER_CONFIG antes de llamar a WdfWmiProviderCreate.

Si el controlador establece la marca WdfWmiProviderExpensive en el miembro Flags de la estructura WDF_WMI_PROVIDER_CONFIG del proveedor de datos WMI y, si el controlador proporciona una función de devolución de llamada EvtWmiProviderFunctionControl , el marco llama a la función de devolución de llamada cuando el controlador debe habilitar o deshabilitar su capacidad de recopilar datos WMI.

En lugar de proporcionar una función de devolución de llamada EvtWmiProviderFunctionControl , el controlador puede llamar a WdfWmiProviderIsEnabled para averiguar si debe habilitar o deshabilitar la recopilación de datos.

Para obtener más información sobre la función de devolución de llamada EvtWmiProviderFunctionControl , vea Compatibilidad con WMI en controladores de Framework-Based.