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) |