NdisCmDeactivateVc 関数 (ndis.h)
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。
スタンドアロンの呼び出しマネージャー (プロトコル ドライバーとして 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) |