WdfWmiInstanceRegister, fonction (wdfwmi.h)

[S’applique uniquement à KMDF]

La méthode WdfWmiInstanceRegister inscrit une instance spécifiée 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 vers un objet d’instance WMI que le pilote a obtenu à partir d’un appel précédent à WdfWmiInstanceCreate.

Valeur de retour

WdfWmiInstanceRegister retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner l’une des valeurs suivantes :

Cette méthode peut également retourner d’autres valeurs NTSTATUS .

Une vérification de bogue 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 de l’instance sur TRUE.

Pour plus d’informations sur la méthode WdfWmiInstanceRegister, consultez Registering Provider Instances. Pour plus d’informations sur WMI, consultez Prise en charge de WMI dans Framework-Based Pilotes.

WdfWmiInstanceRegister inscrit l’instance de fournisseur de manière synchrone (autrement dit, avant de retourner) si elle est appelée à IRQL = PASSIVE_LEVEL et de manière asynchrone si elle est appelée au > PASSIVE_LEVEL IRQL.

Exemples

L’exemple de code suivant inscrit une instance spécifiée d’un fournisseur de données WMI auprès du service WMI du système.

NTSTATUS  status;

status = WdfWmiInstanceRegister(wmiInstance);

Exigences

Voir aussi

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceDeregister