IoGetDiskDeviceObject 함수(ntifs.h)
IoGetDiskDeviceObject 루틴은 지정된 파일 시스템 볼륨 디바이스 개체와 연결된 디스크 디바이스 개체에 대한 포인터를 검색합니다.
구문
NTSTATUS IoGetDiskDeviceObject(
[in] PDEVICE_OBJECT FileSystemDeviceObject,
PDEVICE_OBJECT *DiskDeviceObject
);
매개 변수
[in] FileSystemDeviceObject
파일 시스템 디바이스 개체에 대한 포인터입니다.
DiskDeviceObject
디스크 디바이스 개체에 대한 디바이스 개체의 주소를 받는 변수에 대한 포인터입니다.
반환 값
IoGetDiskDeviceObject는 다음 상태 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
이 함수에 전달된 매개 변수 중 하나가 잘못되었습니다. |
|
|
|
설명
IoGetDiskDeviceObject 는 파일 시스템 볼륨과 연결된 스토리지 디바이스 개체에 대한 포인터를 반환합니다. 스토리지 디바이스는 실제 디스크일 필요가 없습니다.
파일 시스템 필터 드라이버는 일반적으로 파일 시스템 볼륨 디바이스 개체에 대해 IoGetDiskDeviceObject 를 호출하여 볼륨이 탑재되었는지 여부를 확인합니다.
IoGetDiskDeviceObject 는 DeviceObject가 가리키는 디스크 디바이스 개체의 참조 횟수를 증가합니다. 따라서 IoGetDiskDeviceObject에 대한 모든 성공적인 호출은 ObDereferenceObject에 대한 후속 호출과 일치해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 SP4 업데이트 롤업; Windows XP |
| 대상 플랫폼 | 유니버설 |
| 헤더 | ntifs.h(Ntifs.h 포함) |
| 라이브러리 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |