次の方法で共有

NdisMCoActivateVcComplete 関数 (ndis.h)

  • [アーティクル]

NdisMCoActivateVcComplete は、ミニポート ドライバーが以前にNDIS_STATUS_PENDING返された CM によって開始されたアクティブ化 VC 要求の処理が完了したことを NDIS と呼び出しマネージャーに通知します。

構文

void NdisMCoActivateVcComplete(
  [in] NDIS_STATUS         Status,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

パラメーター

[in] Status

activate-VC 操作の最終的な状態を指定します。これは、NDIS_STATUS_SUCCESSすることも、NDIS_STATUS_PENDING 以外の任意のNDIS_STATUS_ XXX にすることもできます。

[in] NdisVcHandle

VC を識別するハンドルを指定します。 呼び出し元は、VC ごとの状態からこのハンドルを取得しました。このハンドルは、ミニポートVcContext によって指定 入力パラメーターとして渡されます。ミニポートCoActivateVc 関数を します。

[in] CallParameters

vc アクティブ化の呼び出しとメディア パラメーターを指定する、呼び出しマネージャーによって提供される CO_CALL_PARAMETERS型の構造体へのポインター。

戻り値

何一つ

備考

接続指向のミニポート ドライバーは、指定された NdisVcHandle によって識別される VC をアクティブ化または再アクティブ化する要求に応答して、ミニポートCoActivateVc 関数が以前にNDIS_STATUS_PENDING返された場合に、NdisMCoActivateVcComplete を呼び出す必要があります。 呼び出しマネージャーは、ndisCmActivateVc 呼び出しで VC のアクティブ化を開始した、ミニポート ドライバーが NdisMCoActivateVcComplete を呼び出すまで、指定された呼び出しパラメーターを使用して VC の転送を行うことができるかどうかを NDIS またはそのクライアントに通知できません。

ミニポート ドライバーは、許容できない CM 提供の呼び出しパラメーターを見つけた場合、NDISMCoActivateVcComplete を呼び出すときに VC のアクティブ化に失敗します。 VC の最初のアクティブ化に失敗すると、VC を作成したプロトコルによって破棄される可能性があります。 ミニポート ドライバーが新しい呼び出しパラメーターを使用して確立された VC を再アクティブ化する要求に失敗した場合は、その VC に対して確立された元の呼び出しパラメーターを復元する必要があります。 ネットワーク メディアの性質に応じて、ミニポート ドライバーは、NdisMCoActivateVcComplete を呼び出す前に、切り上げフラグまたは切り下げフラグ設定されている場合、メディア パラメーターを変更できます。

NdisMCoActivateVcComplete を 呼び出すと、NDIS が ProtocolCmActivateVcComplete 最初に VC のアクティブ化を要求した呼び出しマネージャーの関数です。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (NdisMCoActivateVcComplete (NDIS 5.1) を参照) でサポートされています。 Windows XP で NDIS 5.1 ドライバー (NdisMCoActivateVcComplete (NDIS 5.1) を参照) でサポートされています。
ターゲット プラットフォーム の デスクトップ
ヘッダー ndis.h (Ndis.h を含む)
ライブラリ Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 を する Irql_MCO_Function(ndis)

関連項目

CO_CALL_PARAMETERS

ミニポートコアクティブ化Vc の

NdisCmActivateVc の

NdisCmDeactivateVc の

ProtocolCmActivateVcComplete