PROTOCOL_CO_DELETE_VC コールバック関数 (ndis.h)

ProtocolCoDeleteVc 関数が必要です。 この関数は、その VC の元の作成者によって閉じられている確立された仮想接続のクライアントまたは呼び出しマネージャーの状態を破棄します。

構文

PROTOCOL_CO_DELETE_VC ProtocolCoDeleteVc;

NDIS_STATUS ProtocolCoDeleteVc(
  [in] NDIS_HANDLE ProtocolVcContext
)
{...}

パラメーター

[in] ProtocolVcContext

クライアントまたは呼び出しマネージャーの VC ごとのコンテキスト領域へのハンドルを指定します。 プロトコルはもともと、ProtocolCoCreateVc 関数からこのハンドルを提供しました。

戻り値

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

備考

ProtocolCoDeleteVc は、ドライバーの ProtocolCoCreateVc 関数の逆数です。 一般に、呼び出しマネージャーまたはクライアントがアクティブ VC に対する操作を実行するために以前に割り当てた動的リソースと構造体を解放します。

ProtocolCoDeleteVc がNDIS_STATUS_SUCCESSを持つコントロールを返すと、NdisVcHandle、その ProtocolCoCreateVc 関数 ProtocolVcContext の領域に格納されている関数が無効になります。

ProtocolCoDeleteVc は、ドライバーによって決定されたNDIS_STATUS_XXX を返して VC の削除を失敗させることができますが、NDIS_STATUS_PENDINGを返 できません。 ProtocolCoDeleteVc 呼び出しは本質的に同期的です。

の例

たとえば、"MyCoDeleteVc" という名前の ProtocolCoDeleteVc 関数を定義するには、次のコード例に示すように PROTOCOL_CO_DELETE_VC 型を使用します。

PROTOCOL_CO_DELETE_VC MyCoDeleteVc;

次に、次のように関数を実装します。

_Use_decl_annotations_
NDIS_STATUS
 MyCoDeleteVc(
    NDIS_HANDLE  ProtocolVcContext
    )
  {...}

PROTOCOL_CO_DELETE_VC 関数の種類は、Ndis.h ヘッダー ファイルで定義されています。 コード分析ツールの実行時にエラーをより正確に識別するには、Use_decl_annotations 注釈を関数定義に追加してください。 Use_decl_annotations 注釈により、ヘッダー ファイル内の PROTOCOL_CO_DELETE_VC 関数型に適用される注釈が確実に使用されます。 関数宣言の要件の詳細については、「ndis ドライバーの の関数の役割の種類を使用して関数を宣言するを参照してください。

Use_decl_annotationsの詳細については、「関数の動作に注釈を付ける」を参照してください。

必要条件

関連項目

NdisClCloseCall の

NdisCoCreateVc の

NdisCoDeleteVc の

ProtocolCoCreateVc