Função WdfWmiProviderGetTracingHandle (wdfwmi.h)
[Aplica-se somente ao KMDF]
O método WdfWmiProviderGetTracingHandle retorna um identificador para o agente de eventos de uma sessão de rastreamento de software WPP .
Sintaxe
ULONGLONG WdfWmiProviderGetTracingHandle(
[in] WDFWMIPROVIDER WmiProvider
);
Parâmetros
[in] WmiProvider
Um identificador para um objeto de provedor WMI que o driver obteve chamando WdfWmiProviderCreate ou WdfWmiInstanceGetProvider.
Retornar valor
WdfWmiProviderGetTracingHandle retorna um identificador para o agente de rastreamento de eventos.
Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.
Comentários
Se um driver definir o sinalizador WdfWmiProviderTracing no membro Flags da estrutura WDF_WMI_PROVIDER_CONFIG do objeto do provedor WMI, ele poderá chamar WdfWmiProviderGetTracingHandle para obter um identificador de rastreamento depois que uma instância do provedor tiver sido registrada. O driver pode usar o identificador de rastreamento como entrada para a rotina WmiTraceMessage .
Para obter mais informações sobre o método WdfWmiProviderGetTracingHandle , consulte Suporte ao Rastreamento de Eventos WMI. Para obter mais informações sobre wmi, consulte Suporte a WMI em drivers de Framework-Based.
Exemplos
O exemplo de código a seguir obtém um identificador para o agente de eventos de uma sessão de rastreamento do WPP.
ULONGLONG tracingHandle;
tracingHandle = WdfWmiProviderGetTracingHandle(wmiProvider);
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfwmi.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.) |
| IRQL | <=DISPATCH_LEVEL |
| Regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |