WdfDriverWdmGetDriverObject 함수(wdfdriver.h)
[KMDF에만 적용]
WdfDriverWdmGetDriverObject 메서드는 지정된 프레임워크 드라이버 개체와 연결된 WDM(Windows 드라이버 모델) 드라이버 개체에 대한 포인터를 검색합니다.
구문론
PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
[in] WDFDRIVER Driver
);
매개 변수
[in] Driver
WdfDriverCreate 또는 WdfGetDriver에 대한 이전 호출에서 드라이버가 가져온 드라이버의 프레임워크 드라이버 개체에 대한 핸들이.
반환 값
WdfDriverWdmGetDriverObjectDRIVER_OBJECT 구조체에 대한 포인터를 반환합니다. 드라이버 핸들이 잘못된 경우 시스템 버그 검사가 수행됩니다.
비고
WdfDriverWdmGetDriverObject 메서드가 반환하는 포인터는 프레임워크 드라이버 개체가 삭제될 때까지 유효합니다. 드라이버가 프레임워크 드라이버 개체에 대한 EvtCleanupCallback 함수를 제공하는 경우 콜백 함수가 반환될 때까지 포인터가 유효합니다.
예시
다음 코드 예제에서는 지정된 프레임워크 드라이버 개체와 연결된 WDM 드라이버 개체에 대한 포인터를 가져옵니다.
PDRIVER_OBJECT pDrvObj;
pDrvObj = WdfDriverWdmGetDriverObject(Driver);
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 KMDF 버전 | 1.0 |
| 헤더 | wdfdriver.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조) |
| IRQL | <= 디스패치_레벨 |
| DDI 규정 준수 규칙 | DriverCreate(kmdf) |