IoGetBootDiskInformation 함수(wdm.h)
IoGetBootDiskInformation 루틴은 부팅 및 시스템 디스크를 설명하는 정보를 반환합니다.
구문
NTSTATUS IoGetBootDiskInformation(
[in, out] PBOOTDISK_INFORMATION BootDiskInformation,
[in] ULONG Size
);
매개 변수
[in, out] BootDiskInformation
루틴이 부팅 및 시스템 디스크에 대한 정보를 반환하는 데 사용하는 호출자 할당 버퍼에 대한 포인터입니다. 루틴은 이 버퍼를 BOOTDISK_INFORMATION 또는 BOOTDISK_INFORMATION_EX 구조체로 채웁니다.
[in] Size
BootDiskInformation에서 지정한 버퍼의 크기(바이트)를 지정합니다. sizeof(BOOTDISK_INFORMATION) 또는 sizeof(BOOTDISK_INFORMATION_EX)여야 합니다.
반환 값
IoGetBootDiskInformation은 다음 상태 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
루틴은 BootDiskInformation으로 지정된 버퍼에서 요청된 정보를 성공적으로 반환했습니다. |
|
Size 값은 BOOTDISK_INFORMATION 구조체의 크기(바이트)보다 작습니다. |
|
드라이버는 시스템이 이미 부팅된 후 루틴을 호출했습니다. 부팅 및 시스템 드라이버만 IoGetBootDiskInformation을 호출한 다음 DriverEntry 또는 AddDevice 루틴에서만 호출할 수 있습니다. |
설명
IoGetBootDiskInformation 은 부팅 드라이버에서만 호출할 수 있습니다. 이 드라이버는 IoRegisterBootDriverReinitialization 루틴을 호출하여 드라이버가 등록하는 콜백 다시 초기화 루틴에서 IoGetBootDiskInformation을 호출해야 합니다.
Windows XP 이상 버전의 Windows에서 Size 매개 변수가 sizeof(BOOTDISK_INFORMATION_EX) 이상인 경우 루틴은 BootDiskInformation 버퍼의 BOOTDISK_INFORMATION_EX 구조를 반환합니다. 그렇지 않으면 Size 가 적어도 sizeof(BOOTDISK_INFORMATION)이면 루틴은 BOOTDISK_INFORMATION 구조를 반환합니다.
Windows 2000에서 루틴은 BOOTDISK_INFORMATION 구조만 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000부터 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |