Функция IoWMIAllocateInstanceIds (wdm.h)

  • Статья

Подпрограмма IoWMIAllocateInstanceIds выделяет один или несколько идентификаторов экземпляров, уникальных для GUID.

Синтаксис

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

Параметры

[in] Guid

Указатель на GUID, для которого создаются идентификаторы экземпляров.

[in] InstanceCount

Указывает, сколько идентификаторов экземпляров должно быть предоставлено.

[out] FirstInstanceId

Указатель на идентификатор первого экземпляра, который должен использовать драйвер.

Возвращаемое значение

IoWMIAllocateInstanceIds возвращает код состояния из следующего списка:

Код возврата Описание
STATUS_SUCCESS
 Указывает, что WMI успешно предоставил уникальные идентификаторы экземпляра для указанного GUID.
STATUS_UNSUCCESSFUL
 Указывает, что службы WMI недоступны.
STATUS_INSUFFICIENT_RESOURCES
 Указывает, что недостаточно ресурсов для предоставления вызывающей стороны идентификаторов экземпляров.

Комментарии

Если в InstanceCount было запрошено больше одного экземпляра и подпрограмма успешно завершена, FirstInstanceId указывает на первый экземпляр, который должен использовать вызывающий объект. Для каждого экземпляра, запрошенного за пределами одного, вызывающий объект должен увеличить значение, возвращаемое в *FirstInstanceId. Например, если вызывающий объект запросил шесть экземпляров и один был возвращен в качестве значения FirstInstanceId, вызывающий объект должен использовать значения 1–6 в качестве уникальных идентификаторов экземпляров.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 2000.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Правила соответствия DDI HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

См. также раздел

IoWmiSuggestInstanceName