WdfObjectDereferenceActual 함수(wdfobject.h)
[KMDF 및 UMDF에 적용]
WdfObjectDereferenceActual 메서드는 지정된 프레임워크 개체에 대한 참조 수를 감소시키고 태그 값, 줄 번호 및 파일 이름을 참조할당합니다.
구문론
void WdfObjectDereferenceActual(
[in] WDFOBJECT Handle,
[in, optional] PVOID Tag,
[in] LONG Line,
[in, optional] PCCH File
);
매개 변수
[in] Handle
프레임워크 개체에 대한 핸들입니다.
[in, optional] Tag
개체 참조를 식별하는 드라이버 정의 값입니다. 태그 값은 드라이버가 이전에 WdfObjectReferenceActual 제공한 태그 값과 일치해야 합니다.
[in] Line
드라이버 소스 파일의 줄 번호를 나타내는 숫자 값입니다.
[in, optional] File
드라이버 소스 파일의 이름을 나타내는 null로 끝나는 상수 문자열에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL 수 있습니다.
반환 값
없음
비고
드라이버에서 잘못된 개체 핸들을 제공하면 버그 검사가 수행됩니다.
개체의 참조 수가 0이 되면 WdfObjectDereferenceActual 반환하기 전에 개체가 삭제될 수 있습니다.
WdfObjectDereference 대신 WdfObjectDereferenceActual 또는 WdfObjectDereferenceWithTag 호출하면 Microsoft 디버거에 추가 정보(태그 문자열, 줄 번호 및 파일 이름)가 제공됩니다. WdfObjectDereferenceActual 사용하면 드라이버가 줄 번호와 파일 이름을 지정할 수 있으며 WdfObjectDereferenceWithTag 드라이버의 현재 줄 번호와 파일 이름을 사용합니다.
!wdftagtracker 디버거 확장명을 사용하여 태그, 줄 번호 및 파일 이름 값을 볼 수 있습니다. 디버거 확장은 태그 값을 포인터 및 일련의 문자로 표시합니다. 디버거 확장에 대한 자세한 내용은 KMDF 드라이버디버깅을 참조하세요.
프레임워크 개체 계층 구조에 대한 개체 참조 수 및 정리 규칙에 대한 자세한 내용은 Framework 개체 수명 주기참조하세요.
예시
다음 코드 예제에서는 개체의 참조 수를 감소시키고 태그 값, 줄 번호 및 파일 이름을 참조에 할당합니다.
WdfObjectDereferenceActual(
object,
pTag,
line,
FILE_NAME
);
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 KMDF 버전 | 1.0 |
| 최소 UMDF 버전 | 2.0 |
| 헤더 | wdfobject.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI 규정 준수 규칙 | DriverCreate(kmdf) |