WdfWmiProviderGetTracingHandle, fonction (wdfwmi.h)

[S’applique uniquement à KMDF]

La méthode WdfWmiProviderGetTracingHandle retourne un handle à l’enregistreur d’événements d’une session de suivi logiciel WPP .

Syntaxe

ULONGLONG WdfWmiProviderGetTracingHandle(
  [in] WDFWMIPROVIDER WmiProvider
);

Paramètres

[in] WmiProvider

Handle pour un objet de fournisseur WMI que le pilote a obtenu en appelant WdfWmiProviderCreate ou WdfWmiInstanceGetProvider.

Valeur retournée

WdfWmiProviderGetTracingHandle retourne un handle à l’enregistreur d’événements tracing.

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Si un pilote définit l’indicateur WdfWmiProviderTracing dans le membre Flags de la structure WDF_WMI_PROVIDER_CONFIG de l’objet du fournisseur WMI, il peut appeler WdfWmiProviderGetTracingHandle pour obtenir un handle de suivi après l’inscription d’un instance fournisseur. Le pilote peut utiliser le handle de suivi comme entrée dans la routine WmiTraceMessage .

Pour plus d’informations sur la méthode WdfWmiProviderGetTracingHandle , consultez Prise en charge du suivi d’événements WMI. Pour plus d’informations sur WMI, consultez Prise en charge de WMI dans les pilotes Framework-Based.

Exemples

L’exemple de code suivant obtient un handle pour l’enregistreur d’événements d’une session de suivi WPP.

ULONGLONG tracingHandle;

tracingHandle = WdfWmiProviderGetTracingHandle(wmiProvider);

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdfwmi.h (inclure Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.)
IRQL	<=DISPATCH_LEVEL
Règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WDF_WMI_PROVIDER_CONFIG

WdfWmiInstanceGetProvider

WdfWmiProviderCreate