Fonction ExpertGetFrame

La fonction ExpertGetFrame retourne le frame demandé à partir d’une capture chargée.

Syntaxe

DWORD WINAPI ExpertGetFrame(
  _In_  HEXPERTKEY              hExpertKey,
  _In_  DWORD                   Direction,
  _In_  DWORD                   RequestFlags,
  _In_  DWORD                   RequestedFrameNumber,
  _In_  HFILTER                 hFilter,
  _Out_ LPEXPERTFRAMEDESCRIPTOR pEFrameDescriptor
);

Paramètres

hExpertKey [in]

Identificateur d’expert unique. Network Monitor transmet l’identificateur hExpertKey à l’expert lorsqu’il appelle la fonction Run .

Direction [in]

Valeur qui identifie la façon dont le Moniteur réseau recherche l’image.

Valeur	Signification
GET_SPECIFIED_FRAME	Retourne le cadre demandé.
GET_FRAME_NEXT_FORWARD	Retourne le cadre suivant.
GET_FRAME_NEXT_BACKWARD	Retourne le cadre précédent.

RequestFlags [in]

Indicateurs qui spécifient la façon dont le Moniteur réseau doit gérer la demande. Spécifiez un ou plusieurs des indicateurs suivants.

Valeur	Signification
FLAGS_DEFER_TO_UI_FILTER	Avant d’appliquer le paramètre de filtre d’affichage de l’expert spécifié dans hFilter, appliquez le filtre d’affichage utilisé par le Moniteur réseau au démarrage de l’expert.
FLAGS_ATTACH_PROPERTIES	Les propriétés que tous les analyseurs de protocole trouvent avec les sections revendiquées de ce frame sont attachées au frame. Si l’indicateur n’est pas défini, le champ lpPropertyTable de la structure EXPERTFRAMEDESCRIPTOR (retourné par pEFrameDescriptor) est défini sur NULL.

RequestedFrameNumber [in]

Numéro du frame demandé.

hFilter [in]

Handle pour le filtre d’affichage expert. Si l’expert n’a pas de filtre d’affichage, définissez le paramètre sur NULL.

pEFrameDescriptor [out]

Structure EXPERTFRAMEDESCRIPTOR qui, au retour, décrit le frame. L’expert doit allouer et libérer la mémoire utilisée par cette structure.

Valeur retournée

Si la fonction réussit, la valeur de retour est NMERR_SUCCESS.

Si la fonction échoue, la valeur de retour indique la raison de l’échec. Si la valeur de retour est NMERR_EXPERT_TERMINATE, l’expert doit immédiatement propre et retourner ; l’utilisateur a abandonné l’exécution de l’expert.

Notes

Si vous définissez FLAGS_ATTACH_PROPERTIES, l’appel nécessite plus de ressources que si vous ne définissez pas l’indicateur. Si l’indicateur n’est pas défini, un pointeur pointe vers l’image brute et vers les données relatives à l’image. Si cet indicateur est défini, le Moniteur réseau attache toutes les propriétés au frame en appelant chaque analyseur qui revendique une partie de l’image. Il peut s’agir d’un processus lent.

Les experts ne doivent pas définir l’indicateur FLAGS_ATTACH_PROPERTIES sauf si les experts exigent les propriétés que les analyseurs attachent au cadre. Si possible, les experts doivent appeler la fonction ExpertGetFrame sans l’indicateur, puis extraire les données requises directement à partir du frame.

Si l’expert appelle ExpertGetFrame sans l’indicateur FLAGS_ATTACH_PROPERTIES et nécessite les propriétés associées à cette trame (un événement, par exemple), il appelle ExpertGetFrame avec les mêmes paramètres, sauf pour les éléments suivants :

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);

L’utilisation du code précédent garantit que l’expert obtient la trame requise sans avoir à appeler à nouveau le code de filtre.

Vous pouvez définir le paramètre hFilter en tant que LPVOID. S’il existe, le frame retourné passe ce filtre. Si l’expert n’a pas de filtre d’affichage à passer à la fonction (si hFilter a la valeur NULL ), le frame retourné n’est pas filtré.

La fonction ExpertGetFrame ne peut être appelée que par des experts qui implémentent la fonction d’exportation Exécuter ou Configurer .

Spécifications