WdfObjectDereference 매크로
[KMDF 및 UMDF에 적용]
WdfObjectDereference 매크로는 지정된 프레임워크 개체에 대한 참조 수를 감소합니다.
구문
VOID WdfObjectDereference(
[in] WDFOBJECT Handle
);
매개 변수
핸들 [in]
프레임워크 개체에 대한 핸들입니다.
반환 값
없음
드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.
설명
개체의 참조 수가 0이 되면 WdfObjectDereference 가 반환되기 전에 개체가 삭제될 수 있습니다.
드라이버는 이전에 WdfObjectReference 를 호출한 경우에만 WdfObjectDereference를 호출할 수 있습니다.
드라이버는 WdfObjectDereference를 호출하는 대신 WdfObjectDereferenceWithTag 또는 WdfObjectDereferenceActual을 호출할 수 있습니다.
개체 참조 수에 대한 자세한 내용은 프레임워크 개체 수명 주기를 참조하세요.
예제
다음 코드 예제에서는 개체의 참조 수를 감소합니다.
WdfObjectDereference(Object);
요구 사항
대상 플랫폼 |
유니버설 |
최소 KMDF 버전 |
1.0 |
최소 UMDF 버전 |
2.0 |
헤더 |
Wdfobject.h(Wdf.h 포함) |
라이브러리 |
Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF) |
Irql |
<= DISPATCH_LEVEL |
DDI 규정 준수 규칙 |
DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA, wdfioqueuefindrequestfailed, wdfioqueueretrievefoundrequest |