英語で読む

次の方法で共有

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

  • [アーティクル]

接続指向ミニポートには、ミニポートCoCreateVc 関数が必要です。 ミニポートCoCreateVc は、新しい 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 からミニポートInitializeEx 関数を します。

[in] NdisVcHandle

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

[out] MiniportVcContext

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

戻り値

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

備考

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

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

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

*MiniportVcContext = SomeBuffer;

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

の例

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

たとえば、"MyCoCreateVc" という名前の ミニポートCoCreateVc 関数を定義するには、次のコード例に示すように 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 ドライバー (ミニポートCoCreateVc (NDIS 5.1) を参照) でサポートされています。 Windows XP で NDIS 5.1 ドライバー (ミニポートコCreateVc (NDIS 5.1) を参照) でサポートされています。
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ndis.h (Ndis.h を含む)
IRQL <= DISPATCH_LEVEL

関連項目

ミニポートInitializeEx

NdisMSetMiniportAttributes の