Partager via


Fonction ParserTemporaryLockFrame

La fonction ParserTemporaryLockFrame verrouille une image lorsqu’elle entre dans un analyseur et déverrouille l’image lorsque la fonction quitte l’analyseur.

Syntaxe

LPBYTE WINAPI ParserTemporaryLockFrame(
  _In_ HFRAME hFrame
);

Paramètres

hFrame [in]

Gérez le cadre vers lequel pointe l’analyseur.

Valeur retournée

Si la fonction réussit, la valeur de retour est un pointeur vers le premier octet de données dans le cadre.

Si la fonction échoue, la valeur de retour est NULL.

Notes

Les analyseurs ne doivent pas appeler la fonction LockFrame . Si un analyseur prend un verrou, puis génère une erreur ou retourne sans déverrouiller le cadre, l’analyseur laisse le système dans un état où il ne peut pas modifier les protocoles ni couper ou copier des images. Les analyseurs doivent utiliser la fonction ParserTemporaryLockFrame , qui accorde un verrou uniquement pendant le contexte de l’entrée de fonction dans l’analyseur. À la sortie de l’analyseur, le verrou de ce cadre est libéré. Par conséquent, le pointeur n’est valide qu’après le retour de l’analyseur de l’appel à la fonction AttachProperties ou RecognizeFrame .

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server [applications de bureau uniquement]
En-tête
Netmon.h
Bibliothèque
Nmapi.lib
DLL
Nmapi.dll