ExpertGetFrame-Funktion
Die ExpertGetFrame-Funktion gibt den angeforderten Frame aus einer geladenen Erfassung zurück.
Syntax
DWORD WINAPI ExpertGetFrame(
_In_ HEXPERTKEY hExpertKey,
_In_ DWORD Direction,
_In_ DWORD RequestFlags,
_In_ DWORD RequestedFrameNumber,
_In_ HFILTER hFilter,
_Out_ LPEXPERTFRAMEDESCRIPTOR pEFrameDescriptor
);
Parameter
-
hExpertKey [ In]
-
Ein eindeutiger Expertenbezeichner. Netzwerkmonitor übergibt den hExpertKey-Bezeichner an den Experten, wenn er die Run-Funktion aufruft.
-
Richtung [ In]
-
Ein -Wert, der angibt, wie Netzwerkmonitor nach dem Frame sucht.
Wert Bedeutung - GET _ SPECIFIED FRAME (ANGEGEBENEN _ FRAME ABRUFEN)
Gibt den angeforderten Frame zurück. - GET _ FRAME _ NEXT _ FORWARD
Gibt den nächsten Frame zurück. - FRAME _ _ _ WEITER RÜCKWÄRTS ABRUFEN
Gibt den vorherigen Frame zurück. -
RequestFlags [ In]
-
Die Flags, die angeben, wie Netzwerkmonitor die Anforderung behandeln soll. Geben Sie mindestens eines der folgenden Flags an.
Wert Bedeutung - FLAGS _ ZUM _ _ _ BENUTZEROBERFLÄCHENFILTER ZURÜCKSTELLEN
Wenden Sie vor dem Anwenden des Anzeigefilterparameters des Experten, der in hFilter angegeben ist, den Anzeigefilter an, den Netzwerkmonitor beim Starten des Experten verwendet. - FLAGS _ ATTACH _ PROPERTIES
Die Eigenschaften, die alle Protokollparser mit beanspruchten Abschnitten dieses Frames finden, werden an den Frame angefügt. Wenn das Flag nicht festgelegt ist, wird das lpPropertyTable-Feld der EXPERTFRAMEDESCRIPTOR-Struktur (von pEFrameDescriptor zurückgegeben) auf NULL festgelegt. -
RequestedFrameNumber [ In]
-
Die Nummer des angeforderten Frames.
-
hFilter [ In]
-
Ein Handle für den Anzeigefilter des Experten. Wenn der Experte keinen Anzeigefilter hat, legen Sie den Parameter auf NULL fest.
-
pEFrameDescriptor [ out]
-
Die EXPERTFRAMEDESCRIPTOR-Struktur, die bei der Rückgabe den Frame beschreibt. Der Experte muss den von dieser Struktur verwendeten Arbeitsspeicher zuordnen und freigeben.
Rückgabewert
Wenn die Funktion erfolgreich ist, lautet der Rückgabewert NMERR _ SUCCESS.
Wenn die Funktion nicht erfolgreich ist, gibt der Rückgabewert die Ursache für den Fehler an. Wenn der Rückgabewert NMERR _ EXPERT _ TERMINATE lautet, muss der Experte sofort bereinigen und zurückgeben. Der Benutzer hat die Ausführung des Experten abgebrochen.
Hinweise
Wenn Sie FLAGS _ ATTACH _ PROPERTIES festlegen, sind für den Aufruf mehr Ressourcen erforderlich, als wenn Sie das Flag nicht festlegen. Wenn das Flag nicht festgelegt ist, zeigt ein Zeiger auf den rohen Frame und auf Daten über den Frame. Wenn dieses Flag festgelegt ist, fügt Netzwerkmonitor alle Eigenschaften an den Frame an, indem jeder Parser aufgerufen wird, der einen Teil des Frames beansprucht. Dies kann ein langsamer Prozess sein.
Experten sollten das FLAGS ATTACH PROPERTIES-Flag nur festlegen, _ wenn die Experten die Eigenschaften _ benötigen, die Parser an den Frame anfügen. Nach Möglichkeit sollten Experten die ExpertGetFrame-Funktion ohne das -Flag aufrufen und dann die erforderlichen Daten direkt aus dem Frame extrahieren.
Wenn der Experte ExpertGetFrame ohne das FLAGS ATTACH PROPERTIES-Flag aufruft _ und die diesem Frame _ zugeordneten Eigenschaften erfordert (z. B. ein Ereignis), ruft der Experte ExpertGetFrame mit den gleichen Parametern auf, mit Ausnahme der folgenden:
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);
Die Verwendung des vorangehenden Codes stellt sicher, dass der Experte den erforderlichen Frame erhält, ohne den Filtercode erneut aufrufen zu müssen.
Sie können den hFilter-Parameter als LPVOID festlegen. Wenn er vorhanden ist, übergibt der zurückgegebene Frame diesen Filter. Wenn der Experte keinen Anzeigefilter hat, der an die Funktion übergeben werden soll (wenn hFilter NULL ist), wird der zurückgegebene Frame nicht gefiltert.
Die ExpertGetFrame-Funktion kann nur von Experten aufgerufen werden, die die Exportfunktion Ausführen oder Konfigurieren implementieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|