IRTC::Connect (método)

El método Connect conecta el NPP a la red mediante una NIC especificada y proporciona información de configuración para la conexión.

Sintaxis

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

Parámetros

hInputBlob [in]

Controle el BLOB que especifica la NIC a la que se conecta y la información de configuración de esa conexión.

StatusCallbackProc [in]

Dirección de la función de devolución de llamada de estado del usuario, que recibe actualizaciones de estado como desencadenadores. Este parámetro se puede establecer en NULL.

FramesCallbackProc [in]

Dirección de la función de devolución de llamada de fotogramas del usuario, que se usa para recibir actualizaciones de estado, como desencadenadores. Este parámetro se puede establecer en NULL.

UserContext [in]

Valor pasado cuando se llama a la función de devolución de llamada de fotogramas y estado del usuario. Si se especifican ambas funciones de devolución de llamada, deben usar el mismo valor de contexto de usuario. El valor de este parámetro suele ser HWND o un puntero "this".

hErrorBlob [out]

Identificador de un BLOB de error que contiene información de error adicional. Vea Comentarios en la parte inferior de este tema para obtener información sobre lo que se encuentra en el blob de error.

Valor devuelto

Si este método se ejecuta correctamente, el valor devuelto se NMERR_SUCCESS.

Si el método no se realiza correctamente, el valor devuelto es uno de los siguientes códigos de error (que incluyen los errores devueltos por la llamada INTERNA IRTC::Configure ):

Código devuelto	Descripción
NMERR_ALREADY_CONNECTED	Esta instancia del objeto COM de NPP ya está conectada a la red.
NMERR_BLOB_CONVERSION_ERROR	El BLOB de configuración está dañado. La llamada IRTC::Configure genera este error.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	El BLOB de entrada especificado por el parámetro hInputBlob carece de una entrada necesaria para realizar esta operación. La llamada IRTC::Connect o IRTC::Configure puede generar este error. Examine el error BLOB devuelto por hErrorBlob para determinar qué entrada no se encontró.
NMERR_BLOB_NOT_INITIALIZED	No se ha llamado a la función CreateBlob . La llamada IRTC::Configure genera este error.
NMERR_BLOB_STRING_INVALID	La cadena no termina en null. La llamada IRTC::Configure genera este error.
NMERR_ILLEGAL_TRIGGER	La parte del desencadenador del BLOB de entrada está dañada. La llamada IRTC::Configure genera este error.
NMERR_INVALID_BLOB	El objeto especificado en hInputBlob no es un BLOB. La llamada IRTC::Configure genera este error.
NMERR_OUT_OF_MEMORY	La memoria necesaria para realizar esta operación no está disponible. La llamada IRTC::Configure genera este error.
NMERR_TIMEOUT	Se agota el tiempo de espera de la solicitud. La llamada IRTC::Configure genera este error.
NMERR_UPLEVEL_BLOB	El número de versión del BLOB especificado en hInputBlob es incorrecto. La llamada IRTC::Configure genera este error.

Comentarios

Cuando se llama al método Connect , el NPP llama automáticamente al método IRTC::Configure mediante el BLOB proporcionado por hInputBlob. Tenga en cuenta que los códigos de error devueltos por la llamada a IRTC::Configure se devuelven y devuelven mediante la llamada IRTC::Connect .

Se debe llamar a este método para poder empezar a capturar fotogramas. Tenga en cuenta que al conectarse a la red mediante este método, debe seguir usando la interfaz IRTC para capturar fotogramas.

Al llamar a esta función, debe especificar una función de devolución de llamada de estado o marco, incluso si solo actúa como marcador de posición.

El BLOB de entrada especificado por hInputBlob se puede obtener llamando a los métodos GetNPPBlobFromUI, GetNPPBlobTable y SelectNPPBlobFromTable .

El blob de error devuelto en hErrorBlob contiene información de error que el desarrollador o la aplicación pueden usar para solucionar problemas. El error BLOB devuelto por hErrorBlob contiene entradas que Network Monitor no pudo entender ni encontrar en el BLOB de entrada especificado en hInputBlob. Por ejemplo, si se devuelve NMERR_BLOB_ENTRY_DOES_NOT_EXIST, la entrada Network Monitor no se encuentra en el blob de error devuelto.

Para información acerca de	Vea
Obtención del BLOB de entrada que representa una NIC	Selección de una tarjeta de interfaz de red

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

Consulte también

IRTC

IRTC::Configure

IRTC::D isconnect

IRTC::Start