WdfWmiInstanceRegister, fonction (wdfwmi.h)
[S’applique à KMDF uniquement]
La méthode WdfWmiInstanceRegister inscrit un instance spécifié d’un fournisseur de données WMI auprès du service WMI du système.
Syntaxe
NTSTATUS WdfWmiInstanceRegister(
[in] WDFWMIINSTANCE WmiInstance
);
Paramètres
[in] WmiInstance
Handle d’un objet WMI instance que le pilote a obtenu à partir d’un appel précédent à WdfWmiInstanceCreate.
Valeur retournée
WdfWmiInstanceRegister retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner l’une des valeurs suivantes :
Code de retour | Description |
---|---|
|
Le instance WMI spécifié a déjà été inscrit. |
Cette méthode peut également retourner d’autres valeurs NTSTATUS.
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Remarques
Les instances de fournisseur ne sont pas disponibles pour les clients WMI tant qu’elles n’ont pas été inscrites. Votre pilote doit appeler WdfWmiInstanceRegister ou définir le membre Register de la structure WDF_WMI_INSTANCE_CONFIG du instance sur TRUE.
Pour plus d’informations sur la méthode WdfWmiInstanceRegister , consultez Inscription d’instances de fournisseur. Pour plus d’informations sur WMI, consultez Prise en charge de WMI dans les pilotes Framework-Based.
WdfWmiInstanceRegister inscrit le fournisseur instance de manière synchrone (c’est-à-dire avant de retourner) s’il est appelé à IRQL = PASSIVE_LEVEL et de façon asynchrone s’il est appelé au PASSIVE_LEVEL IRQL>.
Exemples
L’exemple de code suivant inscrit un instance spécifié d’un fournisseur de données WMI auprès du service WMI du système.
NTSTATUS status;
status = WdfWmiInstanceRegister(wmiInstance);
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 des versions de la bibliothèque d’infrastructure).) |
IRQL | <=DISPATCH_LEVEL |
Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour