Función ExpertGetFrame
La función ExpertGetFrame devuelve el marco solicitado de una captura cargada.
Sintaxis
DWORD WINAPI ExpertGetFrame(
_In_ HEXPERTKEY hExpertKey,
_In_ DWORD Direction,
_In_ DWORD RequestFlags,
_In_ DWORD RequestedFrameNumber,
_In_ HFILTER hFilter,
_Out_ LPEXPERTFRAMEDESCRIPTOR pEFrameDescriptor
);
Parámetros
-
hExpertKey [in]
-
Un identificador de experto único. Network Monitor pasa el identificador hExpertKey al experto cuando llama a la función Run .
-
Dirección [in]
-
Valor que identifica cómo Network Monitor busca el fotograma.
Valor Significado - GET_SPECIFIED_FRAME
Devuelve el marco solicitado. - GET_FRAME_NEXT_FORWARD
Devuelve el siguiente marco. - GET_FRAME_NEXT_BACKWARD
Devuelve el fotograma anterior. -
RequestFlags [in]
-
Marcas que especifican cómo debe controlar network Monitor la solicitud. Especifique una o varias de las marcas siguientes.
Valor Significado - FLAGS_DEFER_TO_UI_FILTER
Antes de aplicar el parámetro de filtro de visualización del experto que se especifica en hFilter, aplique el filtro de pantalla que usa Network Monitor cuando se inicie el experto. - FLAGS_ATTACH_PROPERTIES
Las propiedades que todos los analizadores de protocolo encuentran con secciones reclamadas de este marco se adjuntan al marco. Si no se establece la marca, el campo lpPropertyTable de la estructura EXPERTFRAMEDESCRIPTOR (devuelto por pEFrameDescriptor) se establecerá en NULL. -
RequestedFrameNumber [in]
-
Número del marco solicitado.
-
hFilter [in]
-
Identificador del filtro de visualización experto. Si el experto no tiene un filtro de visualización, establezca el parámetro en NULL.
-
pEFrameDescriptor [out]
-
La estructura EXPERTFRAMEDESCRIPTOR que, a cambio, describe el marco. El experto debe asignar y liberar la memoria que utiliza esta estructura.
Valor devuelto
Si la función se realiza correctamente, se NMERR_SUCCESS el valor devuelto.
Si la función no se realiza correctamente, el valor devuelto indica el motivo del error. Si el valor devuelto es NMERR_EXPERT_TERMINATE, el experto debe limpiar y devolver inmediatamente; el usuario ha anulado la ejecución del experto.
Observaciones
Si establece FLAGS_ATTACH_PROPERTIES, la llamada requiere más recursos que si no establece la marca. Si no se establece la marca, un puntero apunta al marco sin formato y a los datos sobre el marco. Si se establece esta marca, Monitor de red adjunta todas las propiedades al marco llamando a cada analizador que reclama una parte del marco. Esto puede ser un proceso lento.
Los expertos no deben establecer la marca FLAGS_ATTACH_PROPERTIES a menos que los expertos requieran las propiedades que los analizadores adjuntan al marco. Si es posible, los expertos deben llamar a la función ExpertGetFrame sin la marca y, a continuación, extraer los datos necesarios directamente desde el marco.
Si el experto llama a ExpertGetFrame sin la marca FLAGS_ATTACH_PROPERTIES y requiere las propiedades asociadas a ese fotograma (por ejemplo, un evento), el experto llama a ExpertGetFrame con los mismos parámetros, excepto por lo siguiente:
Direction = EXPERT_GET_SPECIFIED_FRAME;
RequestFlags &= (~EXPERT_DEFER_TO_UI_FILTER) | EXPERT_ATTACH_PROPERTIES;
RequestedFrameNumber= (The actual frame number you want);
hFilter = NULL;
pEFrameDescriptor = (The same one as last time);
El uso del código anterior garantiza que el experto obtenga el marco necesario sin tener que volver a llamar al código de filtro.
Puede establecer el parámetro hFilter como un LPVOID. Si existe, el marco devuelto pasa este filtro. Si el experto no tiene un filtro de presentación para pasar a la función (si hFilter es NULL ), el marco devuelto no se filtra.
Los expertos que implementan la función Ejecutar o Configurar exportación solo pueden llamar a la función ExpertGetFrame.
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 |
|
| Biblioteca |
|
| Archivo DLL |
|