RxpTrackDereference 함수(fcb.h)

아티클
08/07/2023

RxpTrackDereference 는 확인된 빌드에서 역참조 SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB 및 SRV_OPEN 구조체에 대한 요청을 추적하는 데 사용됩니다. 이러한 역참조 요청의 로그는 로깅 시스템 및 WMI에서 액세스할 수 있습니다.

구문

BOOLEAN RxpTrackDereference(
  [in] ULONG TraceType,
  [in] PCSTR FileName,
  [in] ULONG Line,
       PVOID Instance
);

매개 변수

[in] TraceType

추적되는 역참조 요청 유형을 결정하는 값입니다. 이 값은 fcb.h에 정의된 다음 매크로 중 하나일 수 있습니다.

RDBSS_REF_TRACK_SRVCALL

SRV_CALL 구조체에 대한 역참조 요청입니다.

RDBSS_REF_TRACK_NETROOT

NET_ROOT 구조체에 대한 역참조 요청입니다.

RDBSS_REF_TRACK_VNETROOT

V_NET_ROOT 구조체에 대한 역참조 요청입니다.

RDBSS_REF_TRACK_NETFOBX

FOBX 구조체에 대한 역참조 요청입니다.

RDBSS_REF_TRACK_NETFCB

FCB 구조체에 대한 역참조 요청입니다.

RDBSS_REF_TRACK_SRVOPEN

SRV_OPEN 구조체에 대한 역참조 요청입니다.

[in] FileName

이 루틴이 호출된 원본 파일의 이름입니다.

[in] Line

이 루틴이 호출된 소스 파일의 줄 번호입니다.

Instance

역참조할 구조체에 대한 포인터입니다.

반환 값

RxpTrackDereference 는 선택된 빌드에서 항상 TRUE 를 반환합니다.

설명

확인된 빌드에서 RxpTrackDereference 는 SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB 및 SRV_OPEN 구조체를 역참조하는 요청을 추적하는 데 사용됩니다. 소매 빌드의 경우 이 함수는 아무 것도 수행하지 않습니다.

WMI를 사용하도록 설정하면 역참조 요청 로그가 알림을 요청한 사용자 모드 WMI 구성 요소에 WMI 이벤트로 전송됩니다. 또한 지연 요청은 로깅을 사용하는 경우 _RxLog 루틴을 호출하여 I/O 오류 로그 항목을 기록하여 RDBSS 로깅 시스템에 기록됩니다.

이 루틴은 실제로 전달된 구조체를 역참조하지 않습니다(구조체에 대한 참조 횟수 감소).

이 루틴을 호출하는 기본 방법인 디버깅을 위해 fcb.h 에 많은 매크로가 정의되어 있습니다. 이러한 매크로는 SRV_CALL, NET_ROOT, V_NET_ROOT, FOBX, FCB 및 SRV_OPEN 구조에 대한 파일 구조 관리 작업에 사용되는 RxReference 또는 RxDereference 루틴에 대한 래퍼를 제공합니다. 이러한 매크로는 먼저 해당 RxpTrackDereference 루틴을 호출하여 해당 RxDereference 루틴을 호출하기 전에 요청에 대한 진단 정보를 기록합니다.