NdisMCmDeactivateVc 関数 (ndis.h)
NdisMCmDeactivateVc は、特定のアクティブな VC にそれ以上の転送がないことを NDIS に通知します。
構文
NDIS_STATUS NdisMCmDeactivateVc(
[in] NDIS_HANDLE NdisVcHandle
);
パラメーター
[in] NdisVcHandle
VC を識別するハンドルを指定します。 このハンドルは、NDIS が着信呼び出し用に NdisMCmCreateVc を呼び出したとき、または ProtocolCoCreateVc 関数がクライアントによって開始される発信呼び出し用に VC を設定したときに、NDIS によって MCM ドライバーに提供されました。
戻り値
NdisMCmDeactivateVc は 、次のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
NDIS は VC を非アクティブとしてマークしました。 |
|
VC は既に非アクティブ化されているため、この呼び出しは冗長です。 |
注釈
MCM ドライバーは、 NdisMCmDeactivateVc を呼び出しを閉じるのに不可欠な手順として呼び出します。通常は、接続を破棄するネットワーク コンポーネントとのパケット交換後です。
NdisMCmDeactivateVc への正常な呼び出しにより、MCM ドライバーは VC 上の転送の現在の呼び出しパラメーターを破棄し、ミニポート ドライバーによって決定された既定値に再初期化することができます。 ただし、VC が別の呼び出しに対して後で再アクティブ化された場合、クライアントはミニポート ドライバーに新しい呼び出しパラメーターを指定します。
NdisMCmDeactivateVc に渡された NdisVcHandle は、VC の非アクティブ化が完了した後も有効なままです。 VC を非アクティブ化すると、その作成者は VC を再利用または破棄するために再初期化できます。
- VC の非アクティブ化と呼び出しの終了後、クライアントは最初に作成した VC を再利用して NdisClMakeCall を使用して別の呼び出しを行うか、 NdisCoDeleteVc を呼び出して MCM ドライバーの ProtocolCoDeleteVc 関数を呼び出すことができます。
- VC 非アクティブ化と呼び出しの終了後、MCM ドライバーは、最初に作成した VC を再利用して、同じクライアントへの別の着信呼び出しを示すことができます。 NdisMCmDispatchIncomingCall、または NdisMCmDeleteVc を呼び出すことができます。
統合された呼び出し管理のサポートを提供する接続指向ミニポート ドライバーのみが 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) |