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 関数。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisMCoActivateVcComplete (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisMCoActivateVcComplete (NDIS 5.1)」を参照) でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | ndis.h (Ndis.h を含む) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 | Irql_MCO_Function(ndis) |