WdfObjectReferenceWithTag 매크로

[KMDF 및 UMDF에 적용]

WdfObjectReferenceWithTag 매크로는 지정된 프레임워크 개체에 대한 참조 수를 증가시키고 드라이버의 현재 파일 이름과 줄 번호를 참조에 할당합니다. 또한 매크로는 참조에 태그 값을 할당합니다.

구문

VOID WdfObjectReferenceWithTag(
  [in] WDFOBJECT Handle,
  [in] PVOID     Tag
);

매개 변수

핸들 [in]
프레임워크 개체에 대한 핸들입니다.

태그 [in]
프레임워크가 개체 참조에 대한 식별 태그로 저장하는 드라이버 정의 값입니다.

반환 값

없음

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

드라이버 가 WdfObjectReferenceWithTag 를 호출하여 참조 수를 증분하는 경우 드라이버는 WdfObjectDereferenceWithTag 를 호출하여 개수를 감소시켜야 합니다.

WdfObjectReference 대신 WdfObjectReferenceActual 또는 WdfObjectReferenceWithTag를 호출하면 Microsoft 디버거에 추가 정보(태그 값, 줄 번호 및 파일 이름)가 제공됩니다. WdfObjectReferenceActual 을 사용하면 드라이버가 줄 번호와 파일 이름을 지정할 수 있고 WdfObjectReferenceWithTag 는 드라이버의 현재 줄 번호와 파일 이름을 사용합니다.

!wdftagtracker 디버거 확장명을 사용하여 태그, 줄 번호 및 파일 이름 값을 볼 수 있습니다. 디버거 확장은 태그 값을 포인터 및 일련의 문자로 표시합니다. 디버거 확장에 대한 자세한 내용은 KMDF 드라이버 디버깅을 참조하세요.

개체 참조 수에 대한 자세한 내용은 프레임워크 개체 수명 주기를 참조하세요.

예제

다음 코드 예제에서는 개체의 참조 수를 증가시키고 참조에 태그 값을 할당합니다.

WdfObjectReferenceWithTag(
                          object,
                          pTag
                          );

요구 사항

대상 플랫폼	유니버설
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
헤더	Wdfobject.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
Irql	<= DISPATCH_LEVEL

추가 정보

WdfObjectReference