NdisMCmDeactivateVc 関数 (ndis.h)

[アーティクル]
03/05/2024

NdisMCmDeactivateVc は、特定のアクティブな VC にそれ以上の転送がないことを NDIS に通知します。

構文

NDIS_STATUS NdisMCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

パラメーター

[in] NdisVcHandle

VC を識別するハンドルを指定します。このハンドルは、NDIS が着信呼び出し用に NdisMCmCreateVc を呼び出したとき、または ProtocolCoCreateVc 関数がクライアントによって開始される発信呼び出し用に VC を設定したときに、NDIS によって MCM ドライバーに提供されました。

戻り値

NdisMCmDeactivateVc は 、次のいずれかを返すことができます。

リターンコード	説明
NDIS_STATUS_SUCCESS	NDIS は VC を非アクティブとしてマークしました。
NDIS_STATUS_NOT_ACCEPTED	VC は既に非アクティブ化されているため、この呼び出しは冗長です。

注釈

MCM ドライバーは、 NdisMCmDeactivateVc を呼び出しを閉じるのに不可欠な手順として呼び出します。通常は、接続を破棄するネットワークコンポーネントとのパケット交換後です。

NdisMCmDeactivateVc への正常な呼び出しにより、MCM ドライバーは VC 上の転送の現在の呼び出しパラメーターを破棄し、ミニポートドライバーによって決定された既定値に再初期化することができます。ただし、VC が別の呼び出しに対して後で再アクティブ化された場合、クライアントはミニポートドライバーに新しい呼び出しパラメーターを指定します。

NdisMCmDeactivateVc に渡された NdisVcHandle は、VC の非アクティブ化が完了した後も有効なままです。 VC を非アクティブ化すると、その作成者は VC を再利用または破棄するために再初期化できます。

VC の非アクティブ化と呼び出しの終了後、クライアントは最初に作成した VC を再利用して NdisClMakeCall を使用して別の呼び出しを行うか、 NdisCoDeleteVc を呼び出して MCM ドライバーの ProtocolCoDeleteVc 関数を呼び出すことができます。
VC 非アクティブ化と呼び出しの終了後、MCM ドライバーは、最初に作成した VC を再利用して、同じクライアントへの別の着信呼び出しを示すことができます。 NdisMCmDispatchIncomingCall、または NdisMCmDeleteVc を呼び出すことができます。

ドライバーライターは、MCM ドライバーが送信および着信呼び出しの接続を破棄するコンテキストでドライバーが呼び出す (内部) MiniportCoDeactivateVc 関数を持っているかどうかを判断します。

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

要件

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