WdfDeviceWdmGetAttachedDevice 함수(wdfdevice.h)

  • 아티클

[KMDF에만 적용]

WdfDeviceWdmGetAttachedDevice 메서드는 디바이스 스택에서 다음으로 낮은 WDM 디바이스 개체를 반환합니다.

구문

PDEVICE_OBJECT WdfDeviceWdmGetAttachedDevice(
  [in] WDFDEVICE Device
);

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

반환 값

WdfDeviceWdmGetAttachedDevice 는 WDM DEVICE_OBJECT 구조체에 대한 포인터를 반환합니다. 지정한 개체 핸들이 실제 디바이스 개체(PDO)를 나타내는 경우 메서드는 NULL을 반환합니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

WdfDeviceWdmGetAttachedDevice 메서드가 반환하는 포인터는 프레임워크 디바이스 개체가 삭제될 때까지 유효합니다. 드라이버가 프레임워크 디바이스 개체에 대해 EvtCleanupCallback 함수를 제공하는 경우 콜백 함수가 반환될 때까지 포인터가 유효합니다.

예제

다음 코드 예제에서는 디바이스의 PDO, FDO 및 다음 하위 디바이스를 나타내는 WDM 디바이스 개체에 대한 포인터가 포함된 추적 메시지를 만듭니다.

TraceEvents(
            TRACE_LEVEL_INFORMATION,
            DBG_PNP,
            "PDO(0x%p) FDO(0x%p), Lower(0x%p)\n",
            WdfDeviceWdmGetPhysicalDevice(device),
            WdfDeviceWdmGetDeviceObject(device),
            WdfDeviceWdmGetAttachedDevice(device)
            );

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
머리글 wdfdevice.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL <= DISPATCH_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

WdfDeviceWdmGetDeviceObject

WdfDeviceWdmGetPhysicalDevice