Fonction IoWMIAllocateInstanceIds (wdm.h)

Article
02/27/2024

La routine IoWMIAllocateInstanceIds alloue un ou plusieurs ID instance qui sont propres au GUID.

Syntaxe

NTSTATUS IoWMIAllocateInstanceIds(
  [in]  LPCGUID Guid,
  [in]  ULONG   InstanceCount,
  [out] ULONG   *FirstInstanceId
);

Paramètres

[in] Guid

Pointeur vers le GUID pour lequel générer des identificateurs instance.

[in] InstanceCount

Spécifie le nombre d’identificateurs instance à fournir.

[out] FirstInstanceId

Pointeur vers le premier identificateur instance que le pilote doit utiliser.

Valeur retournée

IoWMIAllocateInstanceIds retourne un code status à partir de la liste suivante :

Code de retour	Description
STATUS_SUCCESS	Indique que WMI a correctement fourni des identificateurs de instance uniques pour le GUID spécifié.
STATUS_UNSUCCESSFUL	Indique que les services WMI ne sont pas disponibles.
STATUS_INSUFFICIENT_RESOURCES	Indique que les ressources disponibles étaient insuffisantes pour fournir à l’appelant des ID instance.

Remarques

Si plus d’un instance a été demandé dans InstanceCount et que la routine s’est terminée correctement, FirstInstanceId pointe vers la première instance que l’appelant doit utiliser. Pour chaque instance demandé au-delà d’un, l’appelant doit incrémenter la valeur retournée dans *FirstInstanceId. Par exemple, si l’appelant a demandé six instances et qu’une a été retournée en tant que valeur de FirstInstanceId, l’appelant doit utiliser les valeurs 1 à 6 comme identificateurs de instance uniques.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 2000.
Plateforme cible	Universal
En-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Règles de conformité DDI	HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

Voir aussi

IoWmiSuggestInstanceName

Partager via