NdisMCmDeleteVc 関数 (ndis.h)

[アーティクル]
08/07/2023

NdisMCmDeleteVc は 、呼び出し元によって作成された VC を破棄します。

構文

NDIS_STATUS NdisMCmDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

パラメーター

[in] NdisVcHandle

削除する VC を識別するハンドルを指定します。呼び出し元は、最初に NdisMCmCreateVc からこのハンドルを取得しました。

戻り値

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

リターンコード	説明
NDIS_STATUS_SUCCESS	NDIS によって VC が削除されました。
NDIS_STATUS_NOT_ACCEPTED	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)