IoWMIDeviceObjectToInstanceName, fonction (wdm.h)
La routine IoWMIDeviceObjectToInstanceName détermine le nom de l’instance de classe WMI implémentée par le pilote spécifié par un objet d’appareil.
Syntaxe
NTSTATUS IoWMIDeviceObjectToInstanceName(
[in] PVOID DataBlockObject,
[in] PDEVICE_OBJECT DeviceObject,
[out] PUNICODE_STRING InstanceName
);
Paramètres
[in] DataBlockObject
Pointeur vers un objet de bloc de données WMI. L’appelant ouvre l’objet de bloc de données pour la classe WMI avec IoWMIOpenBlock.
[in] DeviceObject
Spécifie un objet d’appareil. La routine retourne le nom d’instance du pilote correspondant à l’objet de périphérique.
[out] InstanceName
Pointeur vers la structure UNICODE_STRING utilisée par la routine pour retourner le nom de l’instance. L’appelant libère la mémoire tampon retournée dans UNICODE_STRING.
Valeur de retour
La routine retourne un code NTSTATUS. Les valeurs de retour possibles sont les suivantes :
| Retourner le code | Description |
|---|---|
|
L’opération a réussi. La routine stocke le nom de l’instance dans la UNICODE_STRING spécifiée par le paramètre InstanceName. |
|
Le pilote n’implémente aucune instance de la classe WMI spécifiée par DataBlockObject. |
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows XP et versions ultérieures du système d’exploitation Windows. |
| plateforme cible | Universel |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |