Método IRTC::Connect

O método Connect conecta o NPP à rede usando uma NIC especificada e fornece informações de configuração para a conexão.

Sintaxe

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

Parâmetros

hInputBlob [in]

Manipule para o BLOB que especifica a NIC à qual você está se conectando e as informações de configuração dessa conexão.

StatusCallbackProc [in]

Endereço da função de retorno de chamada status do usuário, que recebe status atualizações, como gatilhos. Esse parâmetro pode ser definido como NULL.

FramesCallbackProc [in]

Endereço da função de retorno de chamada de quadro do usuário, que é usada para receber atualizações status, como gatilhos. Esse parâmetro pode ser definido como NULL.

UserContext [in]

Valor passado quando a função de retorno de chamada status e quadro do usuário é chamada. Se ambas as funções de retorno de chamada forem especificadas, elas deverão usar o mesmo valor de contexto de usuário. O valor desse parâmetro normalmente é HWND ou um ponteiro 'this'.

hErrorBlob [out]

Identificador para um BLOB de erro que contém informações de erro adicionais. Consulte Comentários na parte inferior deste tópico para obter informações sobre o que está no BLOB de erro.

Valor retornado

Se esse método for bem-sucedido, o valor retornado será NMERR_SUCCESS.

Se o método não for bem-sucedido, o valor retornado será um dos seguintes códigos de erro (que incluem os erros retornados pela chamada IRTC::Configure interna):

Código de retorno	Descrição
NMERR_ALREADY_CONNECTED	Essa instância do objeto COM NPP já está conectada à rede.
NMERR_BLOB_CONVERSION_ERROR	O BLOB de configuração está corrompido. Esse erro é gerado pela chamada IRTC::Configure .
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	O BLOB de entrada especificado pelo parâmetro hInputBlob não tem uma entrada necessária para executar essa operação. Esse erro pode ser gerado pela chamada IRTC::Connect ou IRTC::Configure . Examine o erro BLOB retornado por hErrorBlob para determinar qual entrada não foi encontrada.
NMERR_BLOB_NOT_INITIALIZED	A função CreateBlob não foi chamada. Esse erro é gerado pela chamada IRTC::Configure .
NMERR_BLOB_STRING_INVALID	A cadeia de caracteres não é terminada em nulo. Esse erro é gerado pela chamada IRTC::Configure .
NMERR_ILLEGAL_TRIGGER	A parte do gatilho do BLOB de entrada está corrompida. Esse erro é gerado pela chamada IRTC::Configure .
NMERR_INVALID_BLOB	O objeto especificado em hInputBlob não é um BLOB. Esse erro é gerado pela chamada IRTC::Configure .
NMERR_OUT_OF_MEMORY	A memória necessária para executar essa operação não está disponível. Esse erro é gerado pela chamada IRTC::Configure .
NMERR_TIMEOUT	A solicitação atingiu o tempo limite. Esse erro é gerado pela chamada IRTC::Configure .
NMERR_UPLEVEL_BLOB	O número de versão do BLOB especificado em hInputBlob está incorreto. Esse erro é gerado pela chamada IRTC::Configure .

Comentários

Quando o método Connect é chamado, o NPP chama automaticamente o método IRTC::Configure usando o BLOB fornecido por hInputBlob. Observe que todos os códigos de erro retornados pela chamada para IRTC::Configure são passados de volta e retornados pela chamada IRTC::Connect .

Esse método deve ser chamado antes que você possa iniciar a captura de quadros. Observe que, ao se conectar à rede usando esse método, você deve continuar a usar a interface IRTC para capturar quadros.

Ao chamar essa função, você deve especificar uma função de retorno de chamada status ou quadro, mesmo que ela atue apenas como um espaço reservado.

O BLOB de entrada especificado por hInputBlob pode ser obtido chamando os métodos GetNPPBlobFromUI, GetNPPBlobTable e SelectNPPBlobFromTable .

O BLOB de erro retornado em hErrorBlob contém informações de erro que o desenvolvedor ou o aplicativo pode usar para solução de problemas. O BLOB de erro retornado por hErrorBlob contém entradas que o Monitor de Rede não pôde entender ou localizar no BLOB de entrada especificado em hInputBlob. Por exemplo, se NMERR_BLOB_ENTRY_DOES_NOT_EXIST for retornado, a entrada Monitor de Rede não pôde localizar será incluída no BLOB de erro retornado.

Para obter informações sobre	Consulte
Obtendo o BLOB de entrada que representa uma NIC	Selecionando uma placa de adaptador de rede

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Netmon.h
DLL	Ndisnpp.dll; Rmtnpp.dll

Confira também

IRTC

IRTC::Configure

IRTC::D isconnect

IRTC::Start