Fonction IoWMIAllocateInstanceIds (wdm.h)

  • Article

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