WdfObjectReferenceWithTag 매크로
[KMDF 및 UMDF에 적용]
WdfObjectReferenceWithTag 매크로는 지정된 프레임워크 개체에 대한 참조 수를 증가시키고 드라이버의 현재 파일 이름 및 줄 번호를 참조에 할당합니다. 또한 매크로는 참조에 태그 값을 할당합니다.
구문
VOID WdfObjectReferenceWithTag(
[in] WDFOBJECT Handle,
[in] PVOID Tag
);
매개 변수
핸들 [in]
프레임워크 개체에 대한 핸들입니다.
태그 [in]
프레임워크가 개체 참조에 대한 식별 태그로 저장하는 드라이버 정의 값입니다.
반환 값
없음
드라이버에서 잘못된 개체 핸들을 제공하는 경우 버그 검사가 발생합니다.
설명
드라이버가 WdfObjectReferenceWithTag 를 호출하여 참조 횟수를 증가시킬 경우 드라이버는 WdfObjectDereferenceWithTag 를 호출하여 개수를 감소시켜야 합니다.
WdfObjectReference 대신 WdfObjectReferenceActual 또는 WdfObjectReferenceWithTag를 호출하면 Microsoft 디버거에 추가 정보(태그 값, 줄 번호 및 파일 이름)가 제공됩니다. WdfObjectReferenceActual 을 사용하면 드라이버에서 줄 번호와 파일 이름을 지정할 수 있고 WdfObjectReferenceWithTag 는 드라이버의 현재 줄 번호와 파일 이름을 사용합니다.
!wdftagtracker 디버거 확장명을 사용하여 태그, 줄 번호 및 파일 이름 값을 볼 수 있습니다. 디버거 확장은 태그 값을 포인터 및 일련의 문자로 표시합니다. 디버거 확장에 대한 자세한 내용은 KMDF 드라이버 디버깅을 참조하세요.
개체 참조 수에 대한 자세한 내용은 Framework 개체 수명 주기를 참조하세요.
예
다음 코드 예제에서는 개체의 참조 수를 증가시키고 참조에 태그 값을 할당합니다.
WdfObjectReferenceWithTag(
object,
pTag
);
요구 사항
대상 플랫폼 |
유니버설 |
최소 KMDF 버전 |
1.0 |
최소 UMDF 버전 |
2.0 |
헤더 |
Wdfobject.h(Wdf.h 포함) |
라이브러리 |
Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF) |
IRQL |
<= DISPATCH_LEVEL |