IoGetConfigurationInformation 함수(ntifs.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 주소 범위 중 하나를 클레임했는지 여부를 나타내는 값도 포함됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000
대상 플랫폼 유니버설
헤더 ntifs.h(Ntddk.h, Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 규정 준수 규칙 HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

추가 정보

HalAssignSlotResources

HalGetBusData

HalGetBusDataByOffset

IoAssignResources

IoQueryDeviceDescription

IoReportResourceUsage