Función de devolución de llamada AttachProperties
La función de exportación AttachProperties asigna las propiedades a una ubicación dentro de un fragmento de datos reconocidos. AttachProperties debe implementarse para cada analizador que admita el archivo DLL del analizador.
Sintaxis
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
);
Parámetros
-
hFrame [in]
-
Identificador del marco que se está a analizar.
-
lpFrame [in]
-
Puntero al primer byte de un marco.
-
lpProtocol [in]
-
Puntero al inicio de los datos reconocidos.
-
MacType [in]
-
Valor MAC del primer protocolo de un marco. MacType puede ser uno de los siguientes:
Valor Significado - MAC_TYPE_ETHERNET
802.3 - MAC_TYPE_TOKENRING
802.5 - MAC_TYPE_FDDI
ANSI X3T9.5 -
BytesLeft [in]
-
Número restante de bytes en un marco que comienza al principio de los datos reconocidos.
-
hPreviousProtocol [in]
-
Identificador del protocolo anterior.
-
nPreviousProtocolOffset [in]
-
Desplazamiento del protocolo anterior a partir del principio del marco.
-
lpInstData [in]
-
Puntero a los datos de instancia que proporciona el protocolo anterior. Los datos de instancia no pueden tener más de un DWORD_PTR de longitud.
Valor devuelto
Si la función es correcta, el valor devuelto es un puntero al primer byte después de los datos reconocidos en un marco o NULL si los datos reconocidos son el último fragmento de datos de un marco.
Si la función no se realiza correctamente, el valor devuelto es un puntero a los datos reconocidos. El parámetro lpProtocol pasa el puntero al archivo DLL del analizador.
Observaciones
Network Monitor llama a la función AttachProperties para cada analizador que reconoce un fragmento de datos en un marco. Tenga en cuenta que el analizador determina qué propiedades existen en los datos reconocidos y dónde se encuentra cada propiedad.
Durante la implementación de AttachProperties, llame a AttachPropertyInstance para usar los datos tal como existen en la captura. También puede llamar a la función AttachPropertyInstanceEx para modificar los datos de propiedad. Sin embargo, se recomienda usar los datos tal como existen en la captura.
Las funciones AttachPropertyInstanceEx y AttachPropertyInstance solo se llaman para las propiedades que existen en los datos reconocidos. Tenga en cuenta que Network Monitor tiene una base de datos de propiedades para el analizador que contiene una descripción de todas las propiedades que admite el analizador.
Datos de instancia
Los datos de instancia son información que se pasa de un analizador a otro. Los datos de instancia pueden ser cualquier dato que sea menor o igual que un DWORD_PTR de longitud, o un puntero a los datos, como los datos de fotogramas sin procesar, que el analizador no tenga que asignar ni liberar. En el parámetro lpInstData de las funciones AttachProperties y RecognizeFrame , Network Monitor proporciona un puntero a los datos de instancia del protocolo anterior. Puede establecer los datos de instancia del analizador durante la implementación de RecognizeFrame.
| Para obtener información acerca de | Vea |
|---|---|
| Qué son los analizadores y cómo funcionan con Network Monitor. | Analizadores |
| Qué puntos de entrada se incluyen en el archivo DLL del analizador. | Arquitectura dll del analizador |
| Cómo reconocer datos. | Implementación de RecognizeFrame |
| Cómo crear una base de datos de propiedades. | Implementación del registro |
| Cómo implementar AttachProperties incluye un ejemplo. | Implementación de AttachProperties |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|