다음을 통해 공유


IoGetAttachedDevice 함수(ntifs.h)

IoGetAttachedDevice 루틴은 지정된 디바이스와 연결된 최상위 디바이스 개체에 대한 포인터를 반환합니다.

구문

PDEVICE_OBJECT IoGetAttachedDevice(
  [in] PDEVICE_OBJECT DeviceObject
);

매개 변수

[in] DeviceObject

맨 위에 연결된 디바이스를 반환할 디바이스 개체에 대한 포인터입니다.

반환 값

IoGetAttachedDevice는 지정된 디바이스에 연결된 최상위 디바이스를 반환합니다.

설명

DeviceObject에서 지정한 디바이스 개체에 연결된 다른 디바이스 개체가 없으면 DeviceObject 및 반환된 포인터가 같습니다.

IoGetAttachedDevice 는 다음과 같은 측면에서 IoGetAttachedDeviceReference 와 다릅니다.

  • IoGetAttachedDevice 는 디바이스 개체에 대한 참조 수를 증가시키지 않습니다. 따라서 ObDereferenceObject 에 대한 일치하는 호출은 필요하지 않습니다.

  • IoGetAttachedDevice의 호출자는 IoGetAttachedDevice가 실행되는 동안 스택에 추가되거나 제거된 디바이스 개체가 없는지 확인해야 합니다. 이 작업을 수행할 수 없는 호출자는 IoGetAttachedDeviceReference 를 대신 사용해야 합니다.

요구 사항

요구 사항
대상 플랫폼 유니버설
헤더 ntifs.h(Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

추가 정보

IoGetAttachedDeviceReference

ObDereferenceObject