AttachProperties 콜백 함수

AttachProperties 내보내기 함수는 속성을 인식된 데이터 조각 내의 위치에 매핑합니다. AttachProperties 는 파서 DLL이 지원하는 각 파서에 대해 구현되어야 합니다.

구문

DWORD AttachProperties(
  _In_ HFRAME    hFrame,
  _In_ LPBYTE    lpFrame,
  _In_ LPBYTE    lpProtocol,
  _In_ DWORD     MacType,
  _In_ DWORD     BytesLeft,
  _In_ HPROTOCOL hPreviousProtocol,
  _In_ DWORD     nPreviousProtocolOffset,
  _In_ DWORD     lpInstData
);

매개 변수

hFrame [in]

구문 분석 중인 프레임의 핸들입니다.

lpFrame [in]

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

lpProtocol [in]

인식된 데이터의 시작 부분에 대한 포인터입니다.

MacType [in]

프레임에 있는 첫 번째 프로토콜의 MAC 값입니다. MacType은 다음 중 하나일 수 있습니다.

값	의미
MAC_TYPE_ETHERNET	802.3
MAC_TYPE_TOKENRING	802.5
MAC_TYPE_FDDI	ANSI X3T9.5

BytesLeft [in]

인식된 데이터의 시작 부분에서 시작하는 프레임의 나머지 바이트 수입니다.

hPreviousProtocol [in]

이전 프로토콜의 핸들입니다.

nPreviousProtocolOffset [in]

프레임의 시작 부분에서 시작하는 이전 프로토콜의 오프셋입니다.

lpInstData [in]

이전 프로토콜에서 제공하는 instance 데이터에 대한 포인터입니다. 인스턴스 데이터는 DWORD_PTR 길이보다 길 수 없습니다.

반환 값

함수가 성공하면 반환 값은 프레임에서 인식된 데이터 뒤의 첫 번째 바이트에 대한 포인터이거나, 인식된 데이터가 프레임의 마지막 데이터인 경우 NULL 입니다.

함수가 실패하면 반환 값은 인식된 데이터에 대한 포인터입니다. lpProtocol 매개 변수는 포인터를 파서 DLL에 전달합니다.

설명

네트워크 모니터는 프레임의 데이터 조각을 인식하는 각 파서에 대해 AttachProperties 함수를 호출합니다. 파서는 인식된 데이터에 존재하는 속성과 각 속성이 있는 위치를 결정합니다.

AttachProperties를 구현하는 동안 AttachPropertyInstance를 호출하여 캡처에 있는 데이터를 사용합니다. AttachPropertyInstanceEx 함수를 호출하여 속성 데이터를 수정할 수도 있습니다. 그러나 캡처에 있는 데이터를 사용하는 것이 좋습니다.

AttachPropertyInstanceEx 및 AttachPropertyInstance 함수는 인식된 데이터에 있는 속성에 대해서만 호출됩니다. 네트워크 모니터에는 파서가 지원하는 모든 속성에 대한 설명이 포함된 파서에 대한 속성 데이터베이스 가 있습니다.

인스턴스 데이터

인스턴스 데이터는 한 파서에서 다른 파서로 전달되는 정보입니다. 인스턴스 데이터는 길이가 DWORD_PTR 이하인 데이터 또는 파서에서 할당하거나 해제할 필요가 없는 원시 프레임 데이터와 같은 데이터에 대한 포인터일 수 있습니다. AttachProperties 및 RecognizeFrame 함수의 lpInstData 매개 변수에서 네트워크 모니터는 이전 프로토콜의 instance 데이터에 대한 포인터를 제공합니다. RecognizeFrame을 구현하는 동안 파서에 대한 instance 데이터를 설정할 수 있습니다.

요구 사항

추가 정보

AttachPropertyInstance

AttachPropertyInstanceEx

RecognizeFrame