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 호출에서 반환된 오류를 포함).
| 반환 코드 | 설명 |
|---|---|
|
NPP COM 개체의 이 instance 이미 네트워크에 연결되어 있습니다. |
|
구성 BLOB이 손상되었습니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다. |
|
hInputBlob 매개 변수로 지정된 입력 BLOB에는 이 작업을 수행하는 데 필요한 항목이 없습니다. 이 오류는 IRTC::Connect 또는 IRTC::Configure 호출에 의해 생성될 수 있습니다.
hErrorBlob에서 반환된 BLOB 오류를 확인하여 찾을 수 없는 항목을 확인합니다. |
|
CreateBlob 함수가 호출되지 않았습니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다. |
|
문자열이 null로 종료되지 않습니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다. |
|
입력 BLOB의 트리거 부분이 손상되었습니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다. |
|
hInputBlob에 지정된 개체가 BLOB이 아닙니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다. |
|
이 작업을 수행하는 데 필요한 메모리를 사용할 수 없습니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다. |
|
요청 시간이 초과되었습니다. 이 오류는 IRTC::Configure 호출에 의해 생성됩니다. |
|
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[데스크톱 앱만] |
| 헤더 |
|
| DLL |
|