NdisMCmDispatchIncomingCall マクロ (ndis.h)

[アーティクル]
02/29/2024

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

構文

void NdisMCmDispatchIncomingCall(
   _SH_,
   _VH_,
   _CP_
);

パラメーター

_SH_

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

_VH_

MCM ドライバーがこの登録済み SAP に送信される着信呼び出しオファーを処理するときに NdisMCmCreateVc で作成された VC を識別するハンドルを指定します。

_CP_

VC の呼び出しパラメーターとメディアパラメーターを指定する CO_CALL_PARAMETERS 型の構造体へのポインター。

戻り値

なし

解説

NdisMCmDispatchIncomingCall を呼び出す前に、MCM ドライバーは既に次の処理を行っています。

ネットワーク経由で受信した呼び出し (実際には接続の要求) に対して、以前に特定のクライアントによって登録されたターゲット SAP を識別しました
NdisMCmCreateVc を使用して着信呼び出し用の VC を作成しました
ネットワーク経由で許容される呼び出しパラメーターについてネゴシエートされた場合、またはリモートノードから送信された呼び出しパラメーターを受け入れた可能性があります
NdisMCmActivateVc を使用して VC をアクティブ化し、ネゴシエートされた呼び出しパラメーターまたは受け入れられた呼び出しパラメーターに従って VC 上で転送する準備ができていることを NDIS に通知しました

NdisMCmDispatchIncomingCall に対する MCM ドライバーの呼び出しにより、NDIS はクライアントの ProtocolClIncomingCall 関数を呼び出し、クライアントが要求された接続を受け入れるか拒否します。接続を受け入れるかどうかを決定した後、クライアントは NdisClIncomingCallComplete を呼び出し、MCM ドライバーの ProtocolCmIncomingCallComplete 関数を 呼び出します。クライアントが呼び出しを受け入れた場合、MCM ドライバーは次にを呼び出します NdisMCmDispatchCallConnected。それ以外の場合は、提供された呼び出しが拒否されたことをリモートノードに通知した後、作成した VC を非アクティブ化 (および削除する可能性があります) します。

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisMCmDispatchIncomingCall (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisMCmDispatchIncomingCall (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム	デスクトップ
Header	ndis.h (Ndis.h を含む)
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	Irql_MCM_Function(ndis)