WdfWorkItemGetParentObject 함수(wdfworkitem.h)
[KMDF 및 UMDF에 적용]
WdfWorkItemGetParentObject 메서드는 지정된 작업 항목이 연결된 프레임워크 개체를 반환합니다.
구문
WDFOBJECT WdfWorkItemGetParentObject(
[in] WDFWORKITEM WorkItem
);
매개 변수
[in] WorkItem
WdfWorkItemCreate에 대한 이전 호출에서 가져온 프레임워크 작업 항목 개체에 대한 핸들입니다.
반환 값
WdfWorkItemGetParentObject는 드라이버가 이전에 WdfWorkItemCreate라고 할 때 드라이버가 드라이버의 WDF_OBJECT_ATTRIBUTES 구조체의 ParentObject 멤버로 지정한 프레임워크 개체에 대한 핸들을 반환합니다.
드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.
설명
작업 항목에 대한 자세한 내용은 프레임워크 작업 항목 사용을 참조하세요.
예제
다음 코드 예제는 1394 샘플 드라이버의 EvtWorkItem 콜백 함수입니다. 이 예제에서는 작업 항목의 부모 디바이스 개체를 가져오고 드라이버 정의 루틴을 호출하여 작업 항목을 처리한 다음 작업 항목 개체를 삭제합니다.
VOID
t1394_BusResetRoutineWorkItem(
IN WDFWORKITEM WorkItem
)
{
WDFDEVICE Device = WdfWorkItemGetParentObject(WorkItem);
t1394_UpdateGenerationCount(Device);
WdfObjectDelete(WorkItem);
}
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 머리글 | wdfworkitem.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 규정 준수 규칙 | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |