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

Artículo
02/07/2025

[Solo se aplica a KMDF]

La función de devolución de llamada EvtWmiProviderFunction Control 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

Un WDF_WMI_PROVIDER_CONTROLvalor con tipo que identifica una funcionalidad que el controlador debe habilitar o deshabilitar.

[in] Enable

Valor booleano que, si TRUE, indica que el controlador debe habilitar la funcionalidad que control especifica. Si 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(estado) es igual a FALSE.

Observaciones

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 el marca de WdfWmiProviderExpensive en la Flags miembro de la estructura WDF_WMI_PROVIDER_CONFIG del proveedor de datos WMI y si el controlador proporciona un EvtWmiProviderFunctionControl función de devolución de llamada, el marco llama a la función de devolución de llamada cuando el controlador debe habilitar o deshabilitar su capacidad para 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 de EvtWmiProviderFunctionControl, vea compatibilidad con WMI en controladores de Framework-Based.