IRTC::Connect, méthode

Article
06/13/2023

La méthode Connect connecte le NPP au réseau à l’aide d’une carte réseau spécifiée et fournit des informations de configuration pour la connexion.

Syntaxe

HRESULT STDMETHODCALLTYPE Connect(
  [in]  HBLOB  hInputBlob,
  [in]  LPVOID StatusCallbackProc,
  [in]  LPVOID FramesCallbackProc,
  [in]  LPVOID UserContext,
  [out] HBLOB  hErrorBlob
);

Paramètres

hInputBlob [in]: Gérez l’objet BLOB qui spécifie la carte réseau à laquelle vous vous connectez et les informations de configuration de cette connexion.
StatusCallbackProc [in]: Adresse de la fonction de rappel status de l’utilisateur, qui reçoit des mises à jour status telles que des déclencheurs. Ce paramètre peut être défini sur NULL.
FramesCallbackProc [in]: Adresse de la fonction de rappel de frame de l’utilisateur, qui est utilisée pour recevoir status mises à jour telles que des déclencheurs. Ce paramètre peut être défini sur NULL.
UserContext [in]: Valeur transmise lorsque la fonction de rappel de status et de frame de l’utilisateur est appelée. Si les deux fonctions de rappel sont spécifiées, elles doivent utiliser la même valeur de contexte utilisateur. La valeur de ce paramètre est généralement HWND ou un pointeur « this ».
hErrorBlob [out]: Gérez dans un objet BLOB d’erreur qui contient des informations d’erreur supplémentaires. Consultez Remarques au bas de cette rubrique pour plus d’informations sur ce qui se trouve dans l’objet BLOB d’erreur.

Valeur retournée

Si cette méthode réussit, la valeur de retour est NMERR_SUCCESS.

Si la méthode échoue, la valeur de retour est l’un des codes d’erreur suivants (qui incluent les erreurs retournées par l’appel IRTC::Configure interne) :

Code de retour	Description
NMERR_ALREADY_CONNECTED	Cette instance de l’objet COM NPP est déjà connectée au réseau.
NMERR_BLOB_CONVERSION_ERROR	L’objet BLOB de configuration est endommagé. Cette erreur est générée par l’appel IRTC::Configure .
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	L’objet BLOB d’entrée spécifié par le paramètre hInputBlob n’a pas d’entrée nécessaire pour effectuer cette opération. Cette erreur peut être générée par l’appel IRTC::Connect ou IRTC::Configure . Examinez l’objet BLOB d’erreur retourné par hErrorBlob pour déterminer l’entrée introuvable.
NMERR_BLOB_NOT_INITIALIZED	La fonction CreateBlob n’a pas été appelée. Cette erreur est générée par l’appel IRTC::Configure .
NMERR_BLOB_STRING_INVALID	La chaîne n’est pas terminée par null. Cette erreur est générée par l’appel IRTC::Configure .
NMERR_ILLEGAL_TRIGGER	La partie déclencheur de l’objet BLOB d’entrée est endommagée. Cette erreur est générée par l’appel IRTC::Configure .
NMERR_INVALID_BLOB	L’objet spécifié dans hInputBlob n’est pas un objet BLOB. Cette erreur est générée par l’appel IRTC::Configure .
NMERR_OUT_OF_MEMORY	La mémoire nécessaire pour effectuer cette opération n’est pas disponible. Cette erreur est générée par l’appel IRTC::Configure .
NMERR_TIMEOUT	Le délai de la demande a expiré. Cette erreur est générée par l’appel IRTC::Configure .
NMERR_UPLEVEL_BLOB	Le numéro de version de l’objet BLOB spécifié dans hInputBlob est incorrect. Cette erreur est générée par l’appel IRTC::Configure .

Notes

Lorsque la méthode Connect est appelée, le NPP appelle automatiquement la méthode IRTC::Configure à l’aide de l’objet BLOB fourni par hInputBlob. Notez que tous les codes d’erreur retournés par l’appel à IRTC::Configure sont renvoyés et retournés par l’appel IRTC::Connect .

Cette méthode doit être appelée avant de pouvoir commencer à capturer des images. Notez que lorsque vous vous connectez au réseau à l’aide de cette méthode, vous devez continuer à utiliser l’interface IRTC pour capturer des images.

Lorsque vous appelez cette fonction, vous devez spécifier une fonction de rappel de status ou de frame, même si elle agit uniquement en tant qu’espace réservé.

L’objet BLOB d’entrée spécifié par hInputBlob peut être obtenu en appelant les méthodes GetNPPBlobFromUI, GetNPPBlobTable et SelectNPPBlobFromTable .

L’objet BLOB d’erreur retourné dans hErrorBlob contient des informations d’erreur que le développeur ou l’application peut utiliser pour résoudre les problèmes. L’objet BLOB d’erreur retourné par hErrorBlob contient des entrées que le Moniteur réseau n’a pas pu comprendre ou trouver dans l’objet BLOB d’entrée spécifié dans hInputBlob. Par exemple, si NMERR_BLOB_ENTRY_DOES_NOT_EXIST est retourné, l’entrée Moniteur réseau introuvable est incluse dans l’objet BLOB d’erreur retourné.

Pour obtenir des informations sur	Consultez
Obtention de l’objet BLOB d’entrée qui représente une carte réseau	Sélection d’une carte d’interface réseau

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
DLL	Ndisnpp.dll; Rmtnpp.dll

Voir aussi

IRTC
IRTC::Configure
IRTC::D isconnect
IRTC::Start

Partager via