IoWMISuggestInstanceName, fonction (wdm.h)

2025-02-07

La routine IoWMISuggestInstanceName est utilisée pour demander à WMI de suggérer un nom de base qu’un pilote peut utiliser pour générer des noms d’instance WMI pour l’appareil.

Syntaxe

NTSTATUS IoWMISuggestInstanceName(
  [in, optional] PDEVICE_OBJECT  PhysicalDeviceObject,
  [in, optional] PUNICODE_STRING SymbolicLinkName,
  [in]           BOOLEAN         CombineNames,
  [out]          PUNICODE_STRING SuggestedInstanceName
);

Paramètres

[in, optional] PhysicalDeviceObject

S’il est fourni, pointe vers l’objet de périphérique physique du pilote.

[in, optional] SymbolicLinkName

Si elle est fournie, pointe vers le nom de lien symbolique retourné par IoRegisterDeviceInterface.

[in] CombineNames

Si TRUE, les noms suggérés renvoyés combinent les informations PhysicalDeviceObject et SymbolicLinkName.

[out] SuggestedInstanceName

Pointeur vers une mémoire tampon qui, une fois l’achèvement réussi, contient un UNICODE_STRING qui contient le nom de l’instance suggérée. L’appelant est responsable de la libération de cette mémoire tampon lorsqu’il n’est plus nécessaire.

Valeur de retour

IoWMISuggestInstanceName retourne un code d’état dans la liste suivante :

Retourner le code	Description
STATUS_SUCCESS	Indique que WMI a réussi à terminer cette fonction.
STATUS_UNSUCCESSFUL	Indique que les services WMI ne sont pas disponibles.
STATUS_INSUFFICIENT_RESOURCES	Indique que les ressources insuffisantes étaient disponibles pour fournir à l’appelant une mémoire tampon contenant la chaîne Unicode.
STATUS_NO_MEMORY	Indique que les ressources insuffisantes étaient disponibles pour fournir à l’appelant une mémoire tampon contenant la chaîne Unicode.

Remarques

Si le paramètre CombineNames est TRUE, les deux PhysicalDeviceObject et SymbolicLinkName doivent être spécifiés. Sinon, une seule d’entre elles doit être spécifiée.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 2000.
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

Voir aussi

IoWMIAllocateInstanceIds