NdisMCoActivateVcComplete 関数 (ndis.h)

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

構文

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

パラメーター

[in] Status

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

[in] NdisVcHandle

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

[in] CallParameters

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

戻り値

なし

解説

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

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

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

要件

こちらもご覧ください

CO_CALL_PARAMETERS

MiniportCoActivateVc

NdisCmActivateVc

NdisCmDeactivateVc