NdisCoDeleteVc 関数 (ndis.h)

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

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

構文

NDIS_STATUS NdisCoDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

パラメーター

[in] NdisVcHandle

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

戻り値

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

リターンコード	説明
NDIS_STATUS_SUCCESS	NDIS は VC を削除しました。
NDIS_STATUS_NOT_ACCEPTED	VC はまだアクティブであるため、削除できませんでした。
NDIS_STATUS_CLOSING	この呼び出しは冗長ですが、指定された VC での非アクティブ化はまだ保留中です。

注釈

プロトコルが NdisCoDeleteVc を呼び出す場合は、指定された VC に未処理の呼び出しが存在せず、その VC は既に非アクティブ化されている必要があります。これらの要件を満たすには、次の条件が保持されることを意味します。

呼び出しの破棄がローカルクライアントによって開始された場合、そのクライアントは、指定された NdisVcHandle を使用して NdisClCloseCall を既に呼び出しており、そのクローズ呼び出し要求が正常に完了しました。
呼び出しの破棄がリモートクライアントによって開始された場合、スタンドアロンの呼び出しマネージャーは、指定された NdisVcHandle を使用して NdisCmDeactivateVc を既に呼び出しており、その非アクティブ化要求は正常に完了しました。

その VC を削除できるのは、特定の VC を作成したプロトコルだけです。 NdisCoDeleteVc を呼び出すと、NDIS は、基になるミニポートドライバーのミニポートCoDeleteVc 関数と、呼び出し元が NdisVcHandle を共有するクライアントまたは呼び出しマネージャーの ProtocolCoDeleteVc 関数の両方を呼び出します。

NdisCoDeleteVc がコントロールを返すと、NdisVcHandle は無効になります。

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

要件

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