WdfDeviceWdmGetPhysicalDevice 함수(wdfdevice.h)
[KMDF에만 적용]
WdfDeviceWdmGetPhysicalDevice 메서드는 디바이스 스택에서 물리적 디바이스의 WDM PDO를 검색합니다.
구문
PDEVICE_OBJECT WdfDeviceWdmGetPhysicalDevice(
[in] WDFDEVICE Device
);
매개 변수
[in] Device
프레임워크 디바이스 개체에 대한 핸들입니다.
반환 값
WdfDeviceWdmGetPhysicalDevice 는 DEVICE_OBJECT 구조체에 대한 포인터를 반환합니다.
드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.
호출자가 제어 디바이스 개체를 제공하는 경우 WdfDeviceWdmGetPhysicalDevice는 NULL을 반환합니다.
설명
WdfDeviceWdmGetPhysicalDevice 메서드가 반환하는 포인터는 프레임워크 디바이스 개체가 삭제될 때까지 유효합니다. 드라이버가 프레임워크 디바이스 개체에 대해 EvtCleanupCallback 함수를 제공하는 경우 콜백 함수가 반환될 때까지 포인터가 유효합니다.
예제
WdfDeviceWdmGetPhysicalDevice를 사용하는 코드 예제는 WdfDeviceWdmGetAttachedDevice를 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 유니버설 |
최소 KMDF 버전 | 1.0 |
머리글 | wdfdevice.h(Wdf.h 포함) |
라이브러리 | Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조) |
IRQL | <=DISPATCH_LEVEL |
DDI 규정 준수 규칙 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기