IRTC::Connect 메서드

  • 아티클

Connect 메서드는 지정된 NIC를 사용하여 NPP를 네트워크에 연결하고 연결에 대한 구성 정보를 제공합니다.

구문

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

매개 변수

hInputBlob [in]

연결하려는 NIC 및 해당 연결에 대한 구성 정보를 지정하는 BLOB에 대한 핸들입니다.

StatusCallbackProc [in]

트리거와 같은 상태 업데이트를 수신하는 사용자의 상태 콜백 함수의 주소입니다. 이 매개 변수는 NULL로 설정할 수 있습니다.

FramesCallbackProc [in]

트리거와 같은 상태 업데이트를 수신하는 데 사용되는 사용자의 프레임 콜백 함수의 주소입니다. 이 매개 변수는 NULL로 설정할 수 있습니다.

UserContext [in]

사용자의 상태 및 프레임 콜백 함수가 호출될 때 전달되는 값입니다. 두 콜백 함수가 모두 지정된 경우 동일한 사용자 컨텍스트 값을 사용해야 합니다. 이 매개 변수의 값은 일반적으로 HWND 또는 'this' 포인터입니다.

hErrorBlob [out]

추가 오류 정보가 포함된 오류 BLOB에 대한 핸들입니다. 오류 BLOB에 있는 내용에 대한 자세한 내용은 이 항목의 아래쪽에 있는 설명을 참조하세요.

반환 값

이 메서드가 성공하면 반환 값이 NMERR_SUCCESS.

메서드가 실패하면 반환 값은 다음 오류 코드 중 하나입니다(내부 IRTC::Configure 호출에서 반환된 오류를 포함).

반환 코드 설명
NMERR_ALREADY_CONNECTED
 NPP COM 개체의 이 instance 이미 네트워크에 연결되어 있습니다.
NMERR_BLOB_CONVERSION_ERROR
 구성 BLOB이 손상되었습니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
 hInputBlob 매개 변수로 지정된 입력 BLOB에는 이 작업을 수행하는 데 필요한 항목이 없습니다. 이 오류는 IRTC::Connect 또는 IRTC::Configure 호출에 의해 생성될 수 있습니다. hErrorBlob에서 반환된 BLOB 오류를 확인하여 찾을 수 없는 항목을 확인합니다.
NMERR_BLOB_NOT_INITIALIZED
 CreateBlob 함수가 호출되지 않았습니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다.
NMERR_BLOB_STRING_INVALID
 문자열이 null로 종료되지 않습니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다.
NMERR_ILLEGAL_TRIGGER
 입력 BLOB의 트리거 부분이 손상되었습니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다.
NMERR_INVALID_BLOB
 hInputBlob에 지정된 개체가 BLOB이 아닙니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다.
NMERR_OUT_OF_MEMORY
 이 작업을 수행하는 데 필요한 메모리를 사용할 수 없습니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다.
NMERR_TIMEOUT
 요청 시간이 초과되었습니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다.
NMERR_UPLEVEL_BLOB
 hInputBlob에 지정된 BLOB의 버전 번호가 잘못되었습니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다.

설명

Connect 메서드가 호출되면 NPP는 hInputBlob에서 제공하는 BLOB을 사용하여 IRTC::Configure 메서드를 자동으로 호출합니다. IRTC::Configure 호출에서 반환된 오류 코드는 IRTC::Connect 호출에서 다시 전달되고 반환됩니다.

프레임 캡처를 시작하려면 먼저 이 메서드를 호출해야 합니다. 이 메서드를 사용하여 네트워크에 연결할 때는 IRTC 인터페이스를 사용하여 프레임을 캡처해야 합니다.

이 함수를 호출할 때 자리 표시자 역할을 하는 경우에도 상태 또는 프레임 콜백 함수를 지정해야 합니다.

hInputBlob으로 지정된 입력 BLOB은 GetNPPBlobFromUI, GetNPPBlobTable 및 SelectNPPBlobFromTable 메서드를 호출하여 가져올 수 있습니다.

hErrorBlob에서 반환된 오류 BLOB에는 개발자 또는 애플리케이션이 문제 해결에 사용할 수 있는 오류 정보가 포함되어 있습니다. hErrorBlob에서 반환된 BLOB 오류에는 네트워크 모니터가 hInputBlob에 지정된 입력 BLOB에서 이해하거나 찾을 수 없는 항목이 포함되어 있습니다. 예를 들어 NMERR_BLOB_ENTRY_DOES_NOT_EXIST 반환되는 경우 네트워크 모니터에서 찾을 수 없는 항목이 반환된 오류 BLOB에 포함됩니다.

원하는 정보 참조 항목
NIC를 나타내는 입력 BLOB 가져오기 네트워크 인터페이스 카드 선택

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버
 Windows 2000 Server[데스크톱 앱만]
헤더
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll

추가 정보

IRTC

IRTC::Configure

IRTC::D sconnect

IRTC::Start