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