NdisMCmDeleteVc 関数 (ndis.h)
NdisMCmDeleteVc は 、呼び出し元によって作成された VC を破棄します。
構文
NDIS_STATUS NdisMCmDeleteVc(
[in] NDIS_HANDLE NdisVcHandle
);
パラメーター
[in] NdisVcHandle
削除する VC を識別するハンドルを指定します。 呼び出し元は、最初に NdisMCmCreateVc からこのハンドルを取得しました。
戻り値
NdisMCmDeleteVc は 、次のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
NDIS によって VC が削除されました。 |
|
VC はまだアクティブであるため、削除できませんでした。 |
注釈
MCM ドライバーが NdisMCmDeleteVc を呼び出すときは、指定された VC に未処理の呼び出しが存在せず、その VC が非アクティブ化されている必要があります。 これらの要件を満たすことは、MCM ドライバーが既に NdisMCmDeactivateVc を呼び出し、指定された NdisVcHandle を正常に呼び出したことを意味します。
特定の VC を作成したドライバーのみが、その VC を削除できます。 NdisMCmDeleteVc を呼び出すと、NDIS は、呼び出し元が NdisVcHandle を共有するクライアントの ProtocolCoDeleteVc 関数を呼び出します。
NdisMCmDeleteVc がコントロールを返すと、NdisVcHandle は無効になります。 MCM ドライバーは、削除された VC に関する状態を維持するために割り当てたリソースを解放するか、 NdisMCmCreateVc を呼び出した後の後続の着信通知で再利用できるように準備できます。
ドライバーライターは、MCM ドライバーが送信および着信呼び出しの接続を破棄するコンテキストでドライバーが呼び出す (内部) MiniportCoDeleteVc 関数を持っているかどうかを判断します。
統合された呼び出し管理のサポートを提供する接続指向のミニポート ドライバーのみが NdisMCmDeleteVc を呼び出すことができます。 スタンドアロンの呼び出しマネージャーとクライアント。プロトコル ドライバーとして NDIS に登録する場合は、代わりに NdisCoDeleteVc を呼び出します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisMCmDeleteVc (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisMCmDeleteVc (NDIS 5.1)」を参照) でサポートされています。 |
対象プラットフォーム | デスクトップ |
Header | ndis.h (Ndis.h を含む) |
Library | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI コンプライアンス規則 | Irql_MCM_Function(ndis) |