IoWMIAllocateInstanceIds 함수(wdm.h)
IoWMIAllocateInstanceIds 루틴은 GUID에 고유한 하나 이상의 인스턴스 ID를 할당합니다.
통사론
NTSTATUS IoWMIAllocateInstanceIds(
[in] LPCGUID Guid,
[in] ULONG InstanceCount,
[out] ULONG *FirstInstanceId
);
매개 변수
[in] Guid
인스턴스 식별자를 생성할 GUID에 대한 포인터입니다.
[in] InstanceCount
제공해야 하는 인스턴스 식별자 수를 지정합니다.
[out] FirstInstanceId
드라이버에서 사용해야 하는 첫 번째 인스턴스 식별자에 대한 포인터입니다.
반환 값
IoWMIAllocateInstanceIds 다음 목록에서 상태 코드를 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
|
WMI가 지정된 GUID에 대한 고유 인스턴스 식별자를 성공적으로 제공했음을 나타냅니다. |
|
WMI 서비스를 사용할 수 없음을 나타냅니다. |
|
호출자에게 인스턴스 ID를 제공하는 데 사용할 수 있는 리소스가 부족했음을 나타냅니다. |
발언
InstanceCount 인스턴스가 두 개 이상 요청되고 루틴이 성공적으로 완료된 경우 FirstInstanceId 호출자가 사용해야 하는 첫 번째 인스턴스를 가리킵니다. 요청된 각 인스턴스에 대해 호출자는 *FirstInstanceId반환된 값을 증가시켜야 합니다. 예를 들어 호출자가 6개의 인스턴스를 요청했고 한 인스턴스가 FirstInstanceId값으로 반환된 경우 호출자는 1-6 값을 고유한 인스턴스 식별자로 사용해야 합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000부터 사용할 수 있습니다. |
| 대상 플랫폼 | 보편적 |
| 헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 규정 준수 규칙 | HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport) |