WdfObjectReferenceActual 함수(wdfobject.h)

[KMDF 및 UMDF에 적용]

WdfObjectReferenceActual 메서드는 지정된 프레임워크 개체에 대한 참조 수를 증가시키고 태그 값, 줄 번호 및 파일 이름을 참조에 할당합니다.

구문론

void WdfObjectReferenceActual(
  [in]           WDFOBJECT Handle,
  [in, optional] PVOID     Tag,
  [in]           LONG      Line,
  [in]           PCCH      File
);

매개 변수

[in] Handle

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

[in, optional] Tag

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

[in] Line

드라이버 소스 파일의 줄 번호를 나타내는 숫자 값입니다.

[in] File

드라이버 소스 파일의 이름을 나타내는 null로 끝나는 상수 문자열에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL 수 있습니다.

반환 값

없음

비고

드라이버에서 잘못된 개체 핸들을 제공하면 버그 검사가 수행됩니다.

드라이버가 WdfObjectReferenceActual 호출하여 참조 횟수를 증가시킬 경우 드라이버는 WdfObjectDereferenceActual 호출하여 개수를 줄여야 합니다.

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

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

개체 참조 수에 대한 자세한 내용은 Framework 개체 수명 주기참조하세요.

프레임워크 개체 계층 구조에 대한 정리 규칙에 대한 자세한 내용은 Framework 개체 수명 주기참조하세요.

예시

다음 코드 예제에서는 개체의 참조 수를 증가시키고 태그 값, 줄 번호 및 파일 이름을 참조에 할당합니다.

WdfObjectReferenceActual(
                         object,
                         pTag,
                         line,
                         FILE_NAME
                         );

요구 사항

참고하십시오

WdfObjectReference