Función WdfWmiProviderGetTracingHandle (wdfwmi.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfWmiProviderGetTracingHandle devuelve un identificador al registrador de eventos de una sesión de seguimiento de software de WPP .

Sintaxis

ULONGLONG WdfWmiProviderGetTracingHandle(
  [in] WDFWMIPROVIDER WmiProvider
);

Parámetros

[in] WmiProvider

Identificador de un objeto de proveedor WMI que obtuvo el controlador llamando a WdfWmiProviderCreate o WdfWmiInstanceGetProvider.

Valor devuelto

WdfWmiProviderGetTracingHandle devuelve un identificador al registrador de seguimiento de eventos.

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Comentarios

Si un controlador establece la marca WdfWmiProviderTracing en el miembro Flags del WDF_WMI_PROVIDER_CONFIG estructura del objeto de proveedor WMI, puede llamar a WdfWmiProviderGetTracingHandle para obtener un identificador de seguimiento una vez registrada una instancia del proveedor. El controlador puede usar el identificador de seguimiento como entrada para la rutina WmiTraceMessage .

Para obtener más información sobre el método WdfWmiProviderGetTracingHandle , vea Compatibilidad con el seguimiento de eventos WMI. Para obtener más información sobre WMI, vea Compatibilidad con WMI en controladores de Framework-Based.

Ejemplos

En el ejemplo de código siguiente se obtiene un identificador para el registrador de eventos de una sesión de seguimiento de WPP.

ULONGLONG tracingHandle;

tracingHandle = WdfWmiProviderGetTracingHandle(wmiProvider);

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfwmi.h (incluya Wdf.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceGetProvider

WdfWmiProviderCreate