NdisCmDeactivateVc 関数 (ndis.h)

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

NdisCmDeactivateVc は、特定のアクティブな VC にそれ以上の転送がないことを NDIS と基になるミニポートドライバーに通知します。

構文

NDIS_STATUS NdisCmDeactivateVc(
  [in] NDIS_HANDLE NdisVcHandle
);

パラメーター

[in] NdisVcHandle

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

戻り値

NdisCmDeactivateVc がNDIS_STATUS_PENDING以外のものを返す場合、呼び出しマネージャーは、 ProtocolCmDeactivateVcComplete 関数。それ以外の場合、NDIS は、この操作が完了したときに CM の ProtocolCmDeactivateVcComplete 関数を呼び出します。

注釈

スタンドアロン呼び出しマネージャーは、呼び出しを閉じるのに不可欠な手順として NdisCmDeactivateVc を呼び出します。通常は、呼び出しを破棄するネットワークコンポーネントとのパケット交換の後に行われます。

NdisCmDeactivateVc を呼び出すと、基になるミニポートドライバーの MiniportCoDeactivateVc 関数を呼び出します。これにより、VC 上の転送の現在の呼び出しパラメーターを破棄でき、ミニポートドライバーによって決定された既定値に再初期化される可能性があります。 VC が別の呼び出しに対して後で再アクティブ化された場合、クライアントまたは呼び出しマネージャーはミニポートドライバーに新しい呼び出しパラメーターを提供します。

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

VC の非アクティブ化と呼び出しの終了後、クライアントは最初に作成した VC を再利用して、NdisClMakeCall を使用して別の呼び出しを行うことができます。
VC 非アクティブ化と呼び出しの終了に続いて、CM は、最初に作成した VC を再利用して、同じクライアントへの別の着信呼び出しを示すことができます。 NdisCmDispatchIncomingCall。

再利用されない特定の VC の作成者は、 NdisCoDeleteVc を呼び出してその VC を破棄します。

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

要件

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