IoGetConfigurationInformation 함수(ntddk.h)
IoGetConfigurationInformation 루틴은 I/O 관리자의 전역 구성 정보 구조에 대한 포인터를 반환합니다. 여기에는 로드될 때 드라이버가 나타내는 디바이스 개체가 생성된 실제 디스크, 플로피, CD-ROM, 테이프, SCSI HBA, 직렬 및 병렬 디바이스 수에 대한 현재 값이 포함됩니다.
구문
PCONFIGURATION_INFORMATION IoGetConfigurationInformation();
반환 값
IoGetConfigurationInformation 은 CONFIGURATION_INFORMATION 구조체에 대한 포인터를 반환합니다.
설명
특정 유형의 디바이스 드라이버는 각 드라이버가 디바이스 개체를 만들 때 구성 정보 구조의 값을 사용하여 적절한 숫자 접미사가 있는 디바이스 개체 이름을 생성할 수 있습니다. 디바이스 개체 이름의 숫자 접미사는 0부터 시작하는 개수이지만 구성 정보 구조에서 유지 관리되는 개수는 이미 생성된 특정 형식의 디바이스 개체 수를 나타냅니다. 즉, 구성 정보 수는 1 기반입니다.
IoGetConfigurationInformation을 호출하는 모든 드라이버는 물리적 디바이스를 나타내는 디바이스 개체를 만들 때 이 구조에서 해당 종류의 디바이스 수를 증가시켜야 합니다.
시스템에서 제공하는 SCSI 포트 드라이버는 컴퓨터에 있는 SCSI HBA 수를 제공합니다. SCSI 클래스 드라이버는 이 값을 읽고 클래스 드라이버 유형의 연결된 디바이스를 사용하여 SCSI 버스를 제어할 수 있는 HBA별 미니포트 드라이버 수를 확인할 수 있습니다.
구성 정보 구조에는 이미 로드된 드라이버가 "AT" 디스크 I/O 주소 범위 중 하나를 클레임했는지 여부를 나타내는 값도 포함됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 헤더 | ntddk.h(Ntddk.h, Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 규정 준수 규칙 | HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm) |