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 de sesión.
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.
Observaciones
Si un controlador establece el marca WdfWmiProviderTracing en el Flags miembro de la estructura WDF_WMI_PROVIDER_CONFIG del objeto de proveedor WMI, puede llamar a WdfWmiProviderGetTracingHandle para obtener un identificador de seguimiento después de que se haya registrado una instancia del proveedor. El controlador puede usar el identificador de seguimiento como entrada para la rutina de WmiTraceMessage.
Para obtener más información sobre el método de 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 | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado de | wdfwmi.h (incluya Wdf.h) |
| biblioteca de | 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) |