Implementación de RecognizeFrame

Network Monitors llama a la función RecognizeFrame de un analizador para determinar que el analizador reconoce los datos no reclamados de un fotograma. Los datos no reclamados pueden estar al principio de un marco, pero normalmente los datos no reclamados se encuentran en medio de un marco. En la ilustración siguiente se muestran los datos no reclamados ubicados en medio de un marco.

Network Monitor proporciona la siguiente información cuando llama a la función RecognizeFrame :

• Identificador del marco.
• Puntero al inicio del marco.
• Puntero al inicio de los datos no reclamados.
• Valor MAC del primer protocolo del marco.
• Número de bytes de los datos no reclamados; es decir, los bytes restantes en el marco.
• Identificador del protocolo anterior.
• Desplazamiento del protocolo anterior.

Cuando el archivo DLL del analizador determina que los datos no reclamados comienzan con el protocolo del analizador, el archivo DLL del analizador determina dónde se inicia el protocolo siguiente y qué protocolo sigue. La DLL del analizador funciona de las siguientes maneras condicionales:

• Si el archivo DLL del analizador reconoce datos no reclamados, el archivo DLL del analizador establece el parámetro pProtocolStatus y devuelve un puntero al siguiente protocolo del marco o NULL. Se devuelve NULL si el protocolo actual es el último protocolo del marco.
• Si el archivo DLL del analizador reconoce datos no reclamados e identifica el protocolo que sigue (de la información proporcionada en el protocolo), el archivo DLL del analizador devuelve un puntero al identificador del protocolo siguiente en el parámetro phNextProtocol de la función.
• Si el archivo DLL del analizador no reconoce los datos no reclamados, el archivo DLL del analizador devuelve el puntero al inicio de los datos no reclamados y Network Monitor sigue intentando analizar los datos no reclamados.

Para implementar RecognizeFrame

1. Pruebe para determinar que reconoce el protocolo.

2. Si reconoce datos no reclamados y sabe qué protocolo sigue, establezca pProtocolStatus en PROTOCOL_STATUS_NEXT_PROTOCOL, establezca phNextProtocol en un puntero que apunte al identificador para el protocolo siguiente y, a continuación, devuelva un puntero al protocolo siguiente.

   -o bien-

   Si reconoce datos no reclamados y no sabe qué protocolo sigue, establezca pProtocolStatus en PROTOCOL_STATUS_RECOGNIZED y, a continuación, devuelva un puntero al protocolo siguiente.

   -o bien-

   Si reconoce datos no reclamados y el protocolo es el último protocolo de un marco, establezca pProtocolStatus en PROTOCOL_STATUS_CLAIMED y, a continuación, devuelva NULL.

   -o bien-

   Si no reconoce datos no reclamados, establezca pProtocolStatus en PROTOCOL_STATUS_NOT_RECOGNIZED y, a continuación, devuelva el puntero que se le pasa en pProtocol.

A continuación se muestra una implementación básica de RecognizeFrame.

#include <windows.h>

LPBYTE BHAPI MyProtocol_RecognizeFrame( HFRAME hFrame,
                                        LPBYTE        pMacFrame,
                                        LPBYTE        pProtocol,
                                        DWORD         MacType,
                                        DWORD         BytesLeft,
                                        HPROTOCOL     hPrevProtocol,
                                        DWORD         nPreviuosProtOffset,
                                        LPDWORD       pProtocolStatus,
                                        LPHPROTOCOL   phNextProtocol,
                                        LPDWORD       InstData)
  
  // Test unclaimed data. 
  
  // If unclaimed data is recognized, but you do not know what follows.
  *pProtocolStatus =  PROTOCOL_STATUS_RECOGNIZED;
  return pProtocol + MY_PROTOCOL_LENGTH;
  
  // If unclaimed data is recognized and you know what follows.
  *pProtocolStatus =  PROTOCOL_STATUS_NEXT_PROTOCOL;
  phNextProtocol = GetProtocolFromTable(
                                        hTable,
                                        ItemToFind,
                                        lpInstData);
  return  pProtocol + MY_PROTOCOL_LENGTH;
  
  // If unclaimed data is recognized and the protocol is the last 
  // protocol in the frame.
  *pProtocolStatus =  PROTOCOL_STATUS_CLAIMED;
  return NULL;
  
  // If the unclaimed data is not recognized.
  *pProtocolStatus =  PROTOCOL_STATUS_NOT_RECOGNIZED;
  return *pProtocol;

}