NdisCmDispatchIncomingCall 関数 (ndis.h)

[アーティクル]
08/07/2023

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)」を参照) でサポートされています。
対象プラットフォーム	デスクトップ
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	Irql_CallManager_Function(ndis)