WdfObjectDereferenceWithTag 매크로

[KMDF 및 UMDF에 적용]

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

구문

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

매개 변수

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

태그 [in]
개체 참조를 식별하는 드라이버 정의 값입니다. 태그 값은 드라이버가 이전에 WdfObjectReferenceWithTag에 제공한 태그 값과 일치해야 합니다.

반환 값

없음

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

설명

개체의 참조 수가 0이 되면 WdfObjectDereferenceWithTag 가 반환되기 전에 개체가 삭제될 수 있습니다.

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

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

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

예제

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

WdfObjectDereferenceWithTag(
                            object,
                            pTag
                            );

요구 사항

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

추가 정보

WdfObjectDereference

WdfObjectReferenceWithTag