Función WdfWmiProviderGetTracingHandle (wdfwmi.h)
[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) |