FormatProperties 콜백 함수

FormatProperties 내보내기 함수는 네트워크 모니터 UI의 세부 정보 창에 표시되는 데이터의 형식을 지정합니다. 세부 정보 창에 데이터를 표시하려면 모든 파서 DLL에서 FormatProperties 내보내기 함수를 구현해야 합니다.

구문

DWORD FormatProperties(
  _In_ HFRAME         hFrame,
  _In_ LPBYTE         lpFrame,
  _In_ LPBYTE         lpProtocol,
  _In_ DWORD          nPropertyInsts,
  _In_ LPPROPERTYINST lpPropInst
);

매개 변수

hFrame [in]

구문 분석 중인 프레임에 대한 핸들입니다.

lpFrame [in]

프레임의 첫 번째 바이트에 대한 포인터입니다.

lpProtocol [in]

프레임에서 프로토콜 데이터의 시작 부분에 대한 포인터입니다.

nPropertyInsts [in]

lpPropInst에서 제공하는 PROPERTYINST 구조체의 수입니다.

lpPropInst [in]

PROPERTYINST 구조체의 배열에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값은 TRUE입니다.

함수가 실패하면 반환 값은 FALSE입니다.

설명

네트워크 모니터는 FormatProperties 함수를 호출하여 네트워크 모니터 UI의 세부 정보 창에 데이터를 표시합니다. 일반적으로 FormatProperties 는 프로토콜에 대한 요약 줄의 서식을 지정한 다음 프레임 내에서 프로토콜의 모든 속성 인스턴스의 형식을 지정하기 위해 호출됩니다. 그러나 네트워크 모니터는 특정 파서에 대해 FormatProperties 를 호출하는 횟수를 보장하지 않습니다.

FormatProperties 함수를 구현하는 동안 파서는 간접적으로 FormatPropertyInstance 함수를 호출하여 네트워크 모니터가 제공하는 제네릭 포맷터를 사용하거나 파서에서 정의한 사용자 지정 포맷터 프로시저를 호출할 수 있습니다. lpPropInst 매개 변수의 파서 DLL에 전달된 각 PROPERTYINST 구조체에 대해 포맷터 중 하나를 호출해야 합니다.

요구 사항

추가 정보

FormatPropertyInstance

Propertyinfo

PROPERTYINST