WdfObjectReference 매크로
[KMDF 및 UMDF에 적용]
WdfObjectReference 매크로는 지정된 프레임워크 개체에 대한 참조 수를 증가합니다.
구문
VOID WdfObjectReference(
[in] WDFOBJECT Handle
);
매개 변수
핸들 [in]
프레임워크 개체에 대한 핸들입니다.
반환 값
없음
드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.
설명
드라이버가 WdfObjectReference 를 호출하여 참조 횟수를 증가시킬 경우 드라이버는 WdfObjectDereference 를 호출하여 개수를 감소시켜야 합니다.
드라이버는 WdfObjectReference를 호출하는 대신 WdfObjectReferenceWithTag 또는 WdfObjectReferenceActual을 호출할 수 있습니다.
개체 참조 수에 대한 자세한 내용은 Framework 개체 수명 주기를 참조하세요.
예제
다음 코드 예제에서는 개체의 참조 횟수를 증분합니다.
WdfObjectReference(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 |