NdisMCmCloseCallComplete マクロ (ndis.h)

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

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

構文

void NdisMCmCloseCallComplete(
   _S_,
   _VH_,
   _PH_
);

パラメーター

_S_

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

_VH_

呼び出しの VC へのハンドルを指定します。このハンドルは、 NdisMCmCreateVc を持つ MCM ドライバーによって、または ProtocolCoCreateVc 関数への入力パラメーターとして、VC が最初に作成されたときに NDIS によって提供されました。

_PH_

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

戻り値

なし

解説

MCM ドライバーの ProtocolCmCloseCall 関数がNDIS_STATUS_PENDINGを返す場合は、クライアントと NDIS に接続を切断する試行が正常またはエラーで完了したことを通知するために、その後 NdisMCmCloseCallComplete を呼び出す必要があります。 NdisMCmCloseCallComplete を呼び出すと、NDIS はクライアントの ProtocolClCloseCallComplete 関数を呼び出します。

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

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

要件

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