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(주의 섹션 참조) |