次の方法で共有


NdisCmDispatchIncomingCall 関数 (ndis.h)

NdisCmDispatchIncomingCall は、そのクライアントによって以前に登録された SAP での着信呼び出しをクライアントに通知します。

構文

NDIS_STATUS NdisCmDispatchIncomingCall(
  [in] NDIS_HANDLE         NdisSapHandle,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

パラメーター

[in] NdisSapHandle

SAP を識別するハンドルを指定します。 NDIS は、クライアントが最初に NdisClRegisterSap 呼び出したときにこのハンドルを設定し、呼び出しマネージャーが最初にこのハンドルをそのハンドルの入力パラメーターとして取得したときProtocolCmRegisterSap 関数を します。

[in] NdisVcHandle

呼び出しマネージャーがこの登録済み SAP に向けられた着信呼び出しオファーを処理するときに、NdisCoCreateVc で作成された VC を識別するハンドルを指定します。

[in] CallParameters

VC のトラフィックおよびメディア パラメーターを指定する CO_CALL_PARAMETERS 型の構造体へのポインター。

戻り値

NdisCmDispatchIncomingCall がNDIS_STATUS_PENDING以外のものを返す場合、呼び出しマネージャーは、その呼び出しに対して内部呼び出しを行う必要があります。ProtocolCmIncomingCallComplete 関数を します。 それ以外の場合、NDIS は、この操作が完了したときに CM の ProtocolCmIncomingCallComplete 関数を呼び出します。

備考

NdisCmDispatchIncomingCall 呼び出す前に、スタンドアロンの呼び出しマネージャーは既に次の操作を行っています。

  • ネットワーク経由で受信した呼び出し (実際には接続を行う要求) について、以前に特定のクライアントによって登録されたターゲット SAP を特定しました
  • NdisCoCreateVc を使用して着信呼び出し用の VC 作成しました
  • ネットワーク経由で受け入れ可能な呼び出しパラメーターについてネゴシエートされたか、リモート ノードから送信された呼び出しパラメーターを受け入れた可能性があります
  • NdisCmActivateVcを使用して VC をアクティブ化し、基になるミニポート ドライバーが、ネゴシエートされた呼び出しパラメーターまたは受け入れられた呼び出しパラメーターに従って VC での転送の準備を整える
NDISCmDispatchIncomingCall する CM の呼び出しにより、NDIS はクライアントの ProtocolClIncomingCall 関数を呼び出し、その中でクライアントが要求された接続を受け入れるか拒否します。 接続を受け入れるかどうかを決定した後、クライアントは NdisClIncomingCallComplete を呼び出します。次に、CM を呼び出します。ProtocolCmIncomingCallComplete 関数を します。 クライアントが呼び出しを受け入れた場合、CM は次 NdisCmDispatchCallConnectedを呼び出します。 それ以外の場合は、提供された呼び出しが拒否されたことをリモート ノードに通知した後、作成した VC を非アクティブ化 (および削除する可能性があります) します。

スタンドアロンの呼び出しマネージャーのみ, プロトコル ドライバーとして NDIS に自分自身を登録します, NdisCmDispatchIncomingCallを呼び出すことができます. 代わりに NdisMCmDispatchIncomingCall 統合された呼び出し管理サポート呼び出しを提供する接続指向ミニポート ドライバー

必要条件

要件 価値
サポートされる最小クライアント Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (NdisCmDispatchIncomingCall (NDIS 5.1) を参照) でサポートされています。 Windows XP で NDIS 5.1 ドライバー (NdisCmDispatchIncomingCall (NDIS 5.1) を参照) でサポートされています。
ターゲット プラットフォーム デスクトップ
ヘッダー ndis.h (Ndis.h を含む)
ライブラリ Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 する Irql_CallManager_Function(ndis)

関連項目

CO_CALL_PARAMETERS

NdisClIncomingCallComplete

NdisClRegisterSap

NdisCmActivateVc

NdisCmDeactivateVc

NdisCmDispatchCallConnected

NdisCoCreateVc

NdisCoDeleteVc

NdisCoSendNetBufferLists

NdisMCmDispatchIncomingCall

ProtocolClIncomingCall

ProtocolCmIncomingCallComplete

ProtocolCmRegisterSap

ProtocolCoReceiveNetBufferLists