IoWMIAllocateInstanceIds-Funktion (wdm.h)
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 |
|---|---|
|
Gibt an, dass WMI erfolgreich eindeutige instance Bezeichner für die angegebene GUID bereitgestellt hat. |
|
Gibt an, dass die WMI-Dienste nicht verfügbar sind. |
|
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) |