WdfWmiProviderGetTracingHandle, fonction (wdfwmi.h)
[S’applique uniquement à KMDF]
La méthode WdfWmiProviderGetTracingHandle retourne un handle à l’enregistreur d’événements d’un suivi logiciel WPP session.
Syntaxe
ULONGLONG WdfWmiProviderGetTracingHandle(
[in] WDFWMIPROVIDER WmiProvider
);
Paramètres
[in] WmiProvider
Handle vers un objet de fournisseur WMI obtenu par le pilote en appelant WdfWmiProviderCreate ou WdfWmiInstanceGetProvider.
Valeur de retour
WdfWmiProviderGetTracingHandle retourne un handle à l’enregistreur d’événements de suivi d’événements.
Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.
Remarques
Si un pilote définit l’indicateur WdfWmiProviderTracing dans l’indicateur Flags membre 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’une instance de 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 des événements WMI. Pour plus d’informations sur WMI, consultez Prise en charge de WMI dans Framework-Based Pilotes.
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);
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| d’en-tête | wdfwmi.h (include Wdf.h) |
| bibliothèque | Wdf01000.sys (voir Versioning de la bibliothèque Framework.) |
| IRQL | <=DISPATCH_LEVEL |
| règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |