PROTOCOL_CL_INCOMING_CALLコールバック関数 (ndis.h)
ProtocolClIncomingCall 関数は、着信呼び出しを受け入れる接続指向クライアントによって使用されます。 このようなクライアントには、ProtocolClIncomingCall 関数 必要があります。 それ以外の場合、このようなプロトコル ドライバーの登録 ProtocolClIncomingCall 関数は、単にNDIS_STATUS_NOT_SUPPORTEDを返すことができます。
構文
PROTOCOL_CL_INCOMING_CALL ProtocolClIncomingCall;
NDIS_STATUS ProtocolClIncomingCall(
[in] NDIS_HANDLE ProtocolSapContext,
[in] NDIS_HANDLE ProtocolVcContext,
[in, out] PCO_CALL_PARAMETERS CallParameters
)
{...}
パラメーター
[in] ProtocolSapContext
クライアントが SAP を登録したときに最初に指定したハンドルを指定します。このハンドルは、呼び出しマネージャーがこの着信呼び出しオファーと照合しました。
[in] ProtocolVcContext
ProtocolCoCreateVc 関数によって NDIS に以前に返された、クライアントの VC ごとのコンテキスト領域へのハンドルを指定します。
[in, out] CallParameters
この提供される呼び出しの呼び出しパラメーターを含む、CO_CALL_PARAMETERS 構造体として書式設定されたバッファーへのポインター。
戻り値
ProtocolClIncomingCall は、次のいずれかの状態コードを返すことができます。
| リターン コード | 形容 |
|---|---|
|
クライアントが着信呼び出しオファーを受け入れた。 |
|
クライアントは、この要求を非同期的に処理し、次の要求を呼び出します。閉じる操作が完了すると、NdisClIncomingCallComplete 関数を します。 |
|
クライアントは、ドライバーによって決定された理由で着信呼び出しオファーを拒否しました。 |
備考
ProtocolClIncomingCall への呼び出しは、呼び出しマネージャーがこのクライアントとの接続を確立するために、シグナリング ピアからネットワーク経由で要求を受信したことを示します。 つまり、このような接続を設定する要求は、このクライアントによって以前に呼び出しマネージャーに登録された SAP に送信されました。
呼び出しマネージャーでサポートされているシグナリング プロトコルに応じて、ProtocolClIncomingCall は、着信通話オファーの受け入れをネゴシエートするプロセスの一環としてトラフィック パラメーターを変更できます。また、通話マネージャーが QoS をサポートしている場合は、CallParameters のサービス品質仕様を変更できます。 クライアントは、提供された呼び出しを受け入れる場合、その後、このバッファー構造から必要な情報をコピーする必要があります。
呼び出しマネージャーがクライアントの変更を検出すると仮定すると、NDIS は、最初に呼び出しオファーを開始したリモート ノード上のクライアントへの接続を表すアクティブな VC で転送が可能になったときに、クライアントの ProtocolClIncomingCallConnected 関数を呼び出します。 許容できない変更された呼び出しパラメーターがクライアントから返された場合、呼び出しマネージャーは、このオファー用に作成した VC を破棄して、クライアントの呼び出しを引き起こす可能性があります。ProtocolClIncomingCloseCall を し、代わりに ProtocolCoDeleteVc 関数を します。
の例
ProtocolClIncomingCall 関数を定義するには、まず、定義する関数の型を識別する関数宣言を指定する必要があります。 Windows には、ドライバーの関数の種類のセットが用意されています。 関数の種類を使用して関数を宣言すると、ドライバー のコード分析、静的ドライバー検証ツール (SDV)、およびその他の検証ツールをすると、エラーが検出され、Windows オペレーティング システムのドライバーを記述するための要件になります。たとえば、"MyClIncomingCall" という名前の ProtocolClIncomingCall 関数を定義するには、次のコード例に示すように PROTOCOL_CL_INCOMING_CALL 型を使用します。
PROTOCOL_CL_INCOMING_CALL MyClIncomingCall;
次に、次のように関数を実装します。
_Use_decl_annotations_
NDIS_STATUS
MyClIncomingCall(
NDIS_HANDLE ProtocolSapContext,
NDIS_HANDLE ProtocolVcContext,
PCO_CALL_PARAMETERS CallParameters
)
{...}
PROTOCOL_CL_INCOMING_CALL 関数の種類は、Ndis.h ヘッダー ファイルで定義されています。 コード分析ツールの実行時にエラーをより正確に識別するには、Use_decl_annotations 注釈を関数定義に追加してください。 Use_decl_annotations 注釈により、ヘッダー ファイル内の PROTOCOL_CL_INCOMING_CALL 関数型に適用される注釈が確実に使用されます。 関数宣言の要件の詳細については、「ndis ドライバーの の関数の役割の種類を使用して関数を宣言するを参照してください。
Use_decl_annotationsの詳細については、「関数の動作に注釈を付ける」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (ProtocolClIncomingCall (NDIS 5.1) を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (ProtocolClIncomingCall (NDIS 5.1) を参照) でサポートされています。 |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | ndis.h (Ndis.h を含む) |
| IRQL | <= DISPATCH_LEVEL |
関連項目
NdisClIncomingCallComplete の
NdisCmDispatchIncomingCall の
NdisMCmDispatchIncomingCall の