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

  • [アーティクル]

接続指向ミニポートには、MiniportCoCreateVc 関数が必要です。 MiniportCoCreateVc は、新しい VC が作成されていることをミニポート ドライバーに示すために NDIS によって呼び出されます。

メモMINIPORT_CO_CREATE_VC型を使用して関数を宣言する必要があります。 詳細については、次の例に関するセクションを参照してください。
 

構文

MINIPORT_CO_CREATE_VC MiniportCoCreateVc;

NDIS_STATUS MiniportCoCreateVc(
  [in]  NDIS_HANDLE MiniportAdapterContext,
  [in]  NDIS_HANDLE NdisVcHandle,
  [out] PNDIS_HANDLE MiniportVcContext
)
{...}

パラメーター

[in] MiniportAdapterContext

ミニポート ドライバーがアダプターのこのインスタンスに関する状態情報を保持するミニポート ドライバーによって割り当てられたコンテキスト領域へのハンドルを指定します。 ミニポート ドライバーは、 を呼び出すことによって NDIS にこのハンドルを提供しました NdisMSetMiniportAttributes MiniportInitializeEx 関数。

[in] NdisVcHandle

作成する VC を一意に識別するハンドル (NDIS によって提供) を指定します。 このハンドルはミニポート ドライバーに対して不透明であり、NDIS ライブラリ用に予約されています。

[out] MiniportVcContext

出力時に、ミニポート ドライバーが VC に関する状態を維持するミニポート ドライバーが指定したコンテキスト領域へのハンドルを指定します。

戻り値

リターン コード 説明
NDIS_STATUS_SUCCESS
 ミニポート ドライバーが必要なすべてのリソースを正常に割り当て、新しく作成された VC の要求を処理するためにそれ自体を準備したことを示します。
NDIS_STATUS_RESOURCES
 呼び出しマネージャーが新しい VC で動作するために必要な動的に割り当てられたリソースを取得できなかったことを示します。

注釈

MiniportCoCreateVc は同期関数として記述する必要があり、どのような状況でも、システム全体の障害を引き起こさずにNDIS_STATUS_PENDINGを返すことはできません。

MiniportCoCreateVc は、 ミニポート ドライバーが VC に関する状態情報を維持するために必要なすべてのリソースを割り当てます。 リソースには、メモリ バッファー、イベント、データ構造、およびその他の同様のリソースが含まれますが、これらに限定されません。

必要なすべてのリソースを割り当てた後、ミニポート ドライバーはリソースを使用可能な状態に初期化し、 MiniportVcContext の状態領域へのポインターを返す必要があります。 ハンドルは、ハンドルを逆参照し、状態バッファーへのポインターをハンドルの値として格納することによって設定されます。 例:

*MiniportVcContext = SomeBuffer;

ミニポート ドライバーは、その後ミニポート ドライバーによって呼び出される他の NDIS ライブラリ ルーチンに必要なパラメーターであるため、状態領域に、VC NdisVcHandle へのハンドルを格納する必要があります。

例

MiniportCoCreateVc 関数を定義するには、まず、定義する関数の型を識別する関数宣言を指定する必要があります。 Windows には、ドライバーの関数型のセットが用意されています。 関数の種類を使用して関数を宣言すると、 ドライバーのコード分析、 静的ドライバー検証ツール (SDV)、およびその他の検証ツールでエラーが検出され、Windows オペレーティング システム用のドライバーを記述するための要件になります。

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

MINIPORT_CO_CREATE_VC MyCoCreateVc;

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

_Use_decl_annotations_
NDIS_STATUS
 MyCoCreateVc(
    NDIS_HANDLE  MiniportAdapterContext,
    NDIS_HANDLE  NdisVcHandle,
    PNDIS_HANDLE  MiniportVcContext
    )
  {...}

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

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

要件

要件 値
サポートされている最小のクライアント Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「MiniportCoCreateVc (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「MiniportCoCreateVc (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム Windows
ヘッダー ndis.h (Ndis.h を含む)
IRQL <= DISPATCH_LEVEL

こちらもご覧ください

MiniportInitializeEx

NdisMSetMiniportAttributes