IoWMIAllocateInstanceIds-Funktion (wdm.h)

  • Artikel

Die IoWMIAllocateInstanceIds-Routine weist eine oder mehrere instance IDs zu, die für die GUID eindeutig sind.

Syntax

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

Parameter

[in] Guid

Zeiger auf die GUID, für die instance Bezeichner generiert werden soll.

[in] InstanceCount

Gibt an, wie viele instance-Bezeichner bereitgestellt werden sollen.

[out] FirstInstanceId

Zeiger auf den ersten instance Bezeichner, den der Treiber verwenden soll.

Rückgabewert

IoWMIAllocateInstanceIds gibt einen status Code aus der folgenden Liste zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS
 Gibt an, dass WMI erfolgreich eindeutige instance Bezeichner für die angegebene GUID bereitgestellt hat.
STATUS_UNSUCCESSFUL
 Gibt an, dass die WMI-Dienste nicht verfügbar sind.
STATUS_INSUFFICIENT_RESOURCES
 Gibt an, dass nicht genügend Ressourcen verfügbar waren, um dem Aufrufer instance IDs bereitzustellen.

Hinweise

Wenn in InstanceCount mehr als ein instance angefordert wurde und die Routine erfolgreich abgeschlossen wurde, verweist FirstInstanceId auf die erste instance, die der Aufrufer verwenden soll. Für jede instance, die über eins hinaus angefordert werden, sollte der Aufrufer den in *FirstInstanceId zurückgegebenen Wert erhöhen. Wenn der Aufrufer beispielsweise sechs Instanzen angefordert hat und eine als Wert von FirstInstanceId zurückgegeben wurde, sollte der Aufrufer die Werte 1 bis 6 als eindeutige instance-Bezeichner verwenden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 2000.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

Weitere Informationen

IoWmiSuggestInstanceName