NdisCmCloseCallComplete 関数 (ndis.h)

NdisCmCloseCallComplete は、以前に呼び出しマネージャーが呼び出しを破棄するためにNDIS_STATUS_PENDING返したクライアントの要求の最終的な状態を返します。

構文

void NdisCmCloseCallComplete(
  [in]           NDIS_STATUS Status,
  [in]           NDIS_HANDLE NdisVcHandle,
  [in, optional] NDIS_HANDLE NdisPartyHandle
);

パラメーター

[in] Status

CM が接続を閉じるクライアントの要求の最終的な状態を指定します(NDIS_STATUS_SUCCESSまたは CM によって決定されたNDIS_STATUS_XXX (NDIS_STATUS_PENDINGを除く)。

[in] NdisVcHandle

呼び出しの VC へのハンドルを指定します。 このハンドルは、呼び出しマネージャーまたはクライアントが NdisCoCreateVc を使用して VC が最初に作成されたときに NDIS によって提供されました。 最近では、呼び出しマネージャーは、入力パラメーターとして渡された CallMgrVcContext によって指定された VC ごとの状態からこのハンドルを取得しました。 ProtocolCmCloseCall 関数。

[in, optional] NdisPartyHandle

NdisVcHandle がポイント対ポイント VC を表す場合、またはマルチポイント接続の最後の残りのパーティへのハンドルを表す場合は NULL を指定します。これは、CallMgrPartyContext によって指定されたパーティごとの状態から取得された CM が ProtocolCmCloseCall 関数に入力パラメーターとして渡されます。

戻り値

なし

解説

スタンドアロン呼び出しマネージャーの ProtocolCmCloseCall 関数がNDIS_STATUS_PENDINGを返す場合、CM は NdisCmCloseCallComplete を後で呼び出して、接続の切断の試行が正常に完了したかエラーが発生したかに関係なく、クライアントと NDIS に通知する必要があります。 NdisCmCloseCallComplete を呼び出すと、NDIS はクライアントの を呼び出します。 ProtocolClCloseCallComplete 関数。

NDIS_STATUS_SUCCESSを状態として渡す場合、呼び出しマネージャーは、NdisCmCloseCallComplete を呼び出すとすぐに、ネットワーク経由での転送に使用できない NdisVcHandle (および NdisPartyHandle (存在する場合) を考慮する必要があります。 呼び出しマネージャーが最初に VC を作成した場合は、NdisCmCloseCallComplete に渡したのと同じ NdisVcHandle を使用して NdisCoDeleteVc を呼び出す必要があります。 クライアントがこの VC を作成した場合、呼び出しマネージャーは、 を使用して ProtocolCoDeleteVc 関数の呼び出しを期待できます。
ProtocolVcContext。入力パラメーターと同じ NdisVcHandle を持ちます。

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

要件

こちらもご覧ください

NdisClCloseCall

NdisCoDeleteVc

NdisMCmCloseCallComplete

ProtocolClCloseCallComplete

ProtocolCoDeleteVc