ObDereferenceObject 매크로(wdm.h)

아티클
02/29/2024

ObDereferenceObject 루틴은 지정된 개체의 참조 수를 감소시키고 보존 검사를 수행합니다.

구문

void ObDereferenceObject(
  [in]  a
);

매개 변수

[in] a

개체의 본문에 대한 포인터입니다.

반환 값

없음

설명

ObDereferenceObject 는 시스템 사용을 위해 예약된 값을 반환합니다. 드라이버는 이 값을 VOID로 처리해야 합니다.

ObDereferenceObject 는 개체의 참조 수를 1씩 줄입니다. 개체가 임시로 만들어졌고(생성할 때 OBJ_PERMANENT 플래그가 지정되지 않음) 참조 수가 0에 도달하면 시스템에서 개체를 삭제할 수 있습니다.

드라이버는 참조 횟수를 0으로 줄여 만든 임시 개체를 삭제할 수 있습니다. 드라이버는 만들지 않은 개체를 삭제하려고 시도해서는 안됩니다.

개체가 지정된 OBJ_PERMANENT 개체 특성 플래그를 사용하여 만든 경우 개체는 영구적입니다. 개체 특성에 대한 자세한 내용은 InitializeObjectAttributes를 참조하세요. 영구 개체는 참조 횟수가 1로 만들어지므로 드라이버에서 역참조할 때 삭제되지 않습니다. 드라이버는 ZwMakeTemporaryObject 루틴을 사용하여 만든 영구 개체만 삭제하여 임시로 만들 수 있습니다. 다음 단계를 사용하여 만든 영구 개체를 삭제합니다.

ObDereferenceObject를 호출합니다.
필요한 경우 적절한 ZwOpenXxx 또는 ZwCreateXxx 루틴을 호출하여 개체에 대한 핸들을 가져옵니다.
2단계에서 가져온 핸들을 사용하여 ZwMakeTemporaryObject 를 호출합니다.
2단계에서 가져온 핸들을 사용하여 ZwClose 를 호출합니다.

개체의 현재 스레드에 의한 즉각적인 삭제(ObDereferenceObject 사용)로 인해 교착 상태가 발생할 수 있는 경우 모든 개체, 특히 KTM(커널 트랜잭션 관리자) 개체에 대해 ObDereferenceObject 대신 ObDereferenceObjectDeferDelete를 사용합니다.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	IRQL <= DISPATCH_LEVEL
DDI 규정 준수 규칙	HwStorPortProhibitedDDIs(storport)