NdisCmDispatchIncomingCloseCall 関数 (ndis.h)
NdisCmDispatchIncomingCloseCall は、通常、呼び出しマネージャーがネットワークから接続を閉じる要求を受信したために、アクティブな呼び出しまたは提供された呼び出しを破棄するようにクライアントに指示します。
構文
void NdisCmDispatchIncomingCloseCall(
[in] NDIS_STATUS CloseStatus,
[in] NDIS_HANDLE NdisVcHandle,
[in, optional] PVOID Buffer,
[in] UINT Size
);
パラメーター
[in] CloseStatus
切断要求の理由を示す、CM によって決定NDIS_STATUS_XXXを指定します。 通常のネットワーク操作中、通話マネージャーはNDIS_STATUS_SUCCESSを渡して、アクティブな呼び出しを終了するためにリモート パーティによって開始された要求を受信したことを示します。
[in] NdisVcHandle
切断される呼び出しの VC へのハンドルを指定します。 このハンドルは、VC が最初に作成されたときに NDIS によって提供されました。呼び出しマネージャーかクライアントかにかかわらず、NdisCoCreateVc 。
[in, optional] Buffer
プロトコル固有の切断データが追加されている場合は、呼び出し元によって割り当てられた常駐バッファーへのポインター。 基になるメディアに応じて、このポインターは NULL できます。
[in] Size
バッファーのサイズをバイト単位で指定します。バッファー が NULL 場合は 0 です。
戻り値
何一つ
備考
通常のネットワーク操作の過程で、スタンドアロン CM 呼び出し NdisCmDispatchIncomingCloseCall、CloseStatus をNDIS_STATUS_SUCCESSに設定します。これは、リモート ノード上の対応するクライアントが NdisClCloseCall 呼び出しているためです。
ただし、次のいずれかが発生した場合、呼び出しマネージャー NdisCmDispatchIncomingCloseCall を呼び出すこともできます。
- 通話マネージャーは、着信通話オファーをクライアントに通知しました。 CM がProtocolCmIncomingCallComplete 関数がクライアントの受け入れによって呼び出、クライアントが変更した入力呼び出しパラメーターを検証します。 ProtocolCmIncomingCallComplete は、クライアントが接続にサポートできない呼び出しパラメーターを提案していることを判断するため、NdisCmDispatchIncomingCloseCall 呼び出します。
- 異常なネットワーク状態では、呼び出しマネージャーはアクティブな呼び出しを強制的に破棄します。 たとえば、このクライアントとリモート パーティ間の接続上のリンクがダウンしたときに呼び出しマネージャーに通知された場合、CM は NdisCmDispatchIncomingCloseCall 呼び出して、このような切断された接続に対してクライアントがさらにデータ転送を試行 (または予期) するのを防ぎます。
NdisCmDispatchIncomingCloseCall を 呼び出すと、NDIS はクライアントを呼び出します。ProtocolClIncomingCloseCall 関数を します。
スタンドアロンの呼び出しマネージャーのみ, プロトコル ドライバーとして NDIS に自分自身を登録します, NdisCmDispatchIncomingCloseCallを呼び出すことができます。 呼び出し管理サポート呼び出しを提供する接続指向ミニポート ドライバー代わりに NdisMCmDispatchIncomingCall を します。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (NdisCmDispatchIncomingCloseCall (NDIS 5.1) を参照) でサポートされています。 Windows XP で NDIS 5.1 ドライバー (NdisCmDispatchIncomingCloseCall (NDIS 5.1) を参照) でサポートされています。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | ndis.h (Ndis.h を含む) |
| ライブラリ | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | Irql_CallManager_Function(ndis) |
関連項目
NdisClCloseCall の
NdisCmDispatchIncomingDropParty のNdisCoDeleteVc の
NdisMCmDispatchIncomingCloseCall の ProtocolCoReceiveNetBufferLists