IoGetDiskDeviceObject 함수(ntifs.h)

IoGetDiskDeviceObject 루틴은 지정된 파일 시스템 볼륨 디바이스 개체와 연결된 디스크 디바이스 개체에 대한 포인터를 검색합니다.

구문

NTSTATUS IoGetDiskDeviceObject(
  [in] PDEVICE_OBJECT FileSystemDeviceObject,
       PDEVICE_OBJECT *DiskDeviceObject
);

매개 변수

[in] FileSystemDeviceObject

파일 시스템 디바이스 개체에 대한 포인터입니다.

DiskDeviceObject

디스크 디바이스 개체에 대한 디바이스 개체의 주소를 받는 변수에 대한 포인터입니다.

반환 값

IoGetDiskDeviceObject는 다음 상태 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_INVALID_PARAMETER	이 함수에 전달된 매개 변수 중 하나가 잘못되었습니다.
STATUS_VOLUME_DISMOUNTED
STATUS_SUCCESS

설명

IoGetDiskDeviceObject 는 파일 시스템 볼륨과 연결된 스토리지 디바이스 개체에 대한 포인터를 반환합니다. 스토리지 디바이스는 실제 디스크일 필요가 없습니다.

파일 시스템 필터 드라이버는 일반적으로 파일 시스템 볼륨 디바이스 개체에 대해 IoGetDiskDeviceObject 를 호출하여 볼륨이 탑재되었는지 여부를 확인합니다.

IoGetDiskDeviceObject 는 DeviceObject가 가리키는 디스크 디바이스 개체의 참조 횟수를 증가합니다. 따라서 IoGetDiskDeviceObject에 대한 모든 성공적인 호출은 ObDereferenceObject에 대한 후속 호출과 일치해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 SP4 업데이트 롤업; Windows XP
대상 플랫폼	유니버설
헤더	ntifs.h(Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

추가 정보

IoEnumerateDeviceObjectList

IoGetAttachedDevice

IoGetAttachedDeviceReference

IoGetLowerDeviceObject

ObDereferenceObject