WdfDpcWdmGetDpc 함수(wdfdpc.h)
[KMDF에만 적용]
WdfDpcWdmGetDpc 메서드는 지정된 프레임워크 DPC 개체와 연결된 KDPC 구조체에 대한 포인터를 반환합니다.
구문
PKDPC WdfDpcWdmGetDpc(
[in] WDFDPC Dpc
);
매개 변수
[in] Dpc
프레임워크 DPC 개체에 대한 핸들입니다.
반환 값
WdfDpcWdmGetDpc 는 지정된 프레임워크 DPC 개체와 연결된 KDPC 구조체에 대한 포인터를 반환합니다.
드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.
설명
프레임워크 기반 드라이버가 WdfDpcCreate 를 호출하여 DPC 개체를 만들 때 프레임워크는 KDPC 구조를 만듭니다.
드라이버는 EvtDpcFunc 콜백 함수 내에서 WdfDpcWdmGetDpc를 호출할 수 있습니다.
WdfDpcWdmGetDpc가 반환하는 포인터는 프레임워크 DPC 개체가 삭제될 때까지 유효합니다. 드라이버가 프레임워크 DPC 개체에 대해 EvtCleanupCallback 함수를 제공하는 경우 콜백 함수가 반환될 때까지 포인터가 유효합니다.
예제
다음 코드 예제에서는 지정된 DPC 개체와 연결된 KDPC 구조체에 대한 포인터를 반환합니다. WdfDpcCreate 코드 예제에서는 지정된 DPC 개체를 만든 방법을 보여 냅니다.
PKDPC pWdmDpc;
pWdmDpc = WdfDpcWdmGetDpc(PDevExt->CompleteWriteDpc);
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 머리글 | wdfdpc.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조) |
| IRQL | 모든 수준 |
| DDI 규정 준수 규칙 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |