[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 |
<= 디스패치_레벨 |
DDI 규정 준수 규칙 |
DriverCreate, MemAfterReqCompletedIntIoctlA, MemAfterReqCompletedIoctlA, MemAfterReqCompletedReadA, MemAfterReqCompletedWriteA |