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 オブジェクトのこのインスタンスは、既にネットワークに接続されています。 |
|
構成 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] |
|