다음을 통해 공유


IoGetRelatedDeviceObject 함수(wdm.h)

파일 개체가 지정된 경우 IoGetRelatedDeviceObject 루틴은 해당 디바이스 개체에 대한 포인터를 반환합니다.

통사론

PDEVICE_OBJECT IoGetRelatedDeviceObject(
  [in] PFILE_OBJECT FileObject
);

매개 변수

[in] FileObject

파일 개체에 대한 포인터입니다.

반환 값

IoGetRelatedDeviceObject 디바이스 개체에 대한 포인터를 반환합니다.

발언

기본 스토리지 디바이스를 나타내는 파일 개체에서 호출되는 경우 IoGetRelatedDeviceObject 스토리지 디바이스 스택에서 가장 높은 수준의 디바이스 개체를 반환합니다. 파일 시스템 드라이버 스택에서 가장 높은 수준의 디바이스 개체를 가져오려면 드라이버는 파일 시스템의 드라이버 스택을 나타내는 파일 개체에서 IoGetRelatedDeviceObject 호출해야 하며 파일 시스템을 현재 탑재해야 합니다. 그렇지 않으면 스토리지 디바이스 스택이 파일 시스템 스택 대신 트래버스됩니다.

파일 시스템이 스토리지 디바이스에 탑재되도록 하려면 드라이버가 파일 개체가 나타내는 파일 또는 디바이스를 열 때 FILE_READ_DATA 또는 FILE_WRITE_ATTRIBUTES 같은 적절한 액세스 마스크를 지정해야 합니다. FILE_READ_ATTRIBUTES 지정해도 파일 시스템이 탑재되지 않습니다.

호출자는 IRQL <= DISPATCH_LEVEL 실행되어야 합니다. 일반적으로 이 루틴의 호출자는 IRQL = PASSIVE_LEVEL 실행됩니다.

요구 사항

요구
지원되는 최소 클라이언트 Windows 2000부터 사용할 수 있습니다.
대상 플랫폼 보편적
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL(주의 섹션 참조)

참고 항목

IoGetDeviceObjectPointer