NdisMCmActivateVc 関数 (ndis.h)
NdisMCmActivateVc は、MCM ドライバーが特定の VC で転送を行う準備ができていることを NDIS に通知します。
構文
NDIS_STATUS NdisMCmActivateVc(
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
パラメーター
[in] NdisVcHandle
VC を識別するハンドルを指定します。
[in] CallParameters
呼び出し元によって割り当てられたバッファーへのポインター。 型CO_CALL_PARAMETERSの構造として書式設定され、ミニポート ドライバーがアクティブ化された VC に使用するすべてのメディア固有のパラメーターを含みます。
戻り値
NdisMCmActivateVc がNDIS_STATUS_PENDING以外のものを返す場合、MCM ドライバーは、 ProtocolCmActivateVcComplete 関数。 それ以外の場合、NDIS は、この操作が完了したときに MCM ドライバーの ProtocolCmActivateVcComplete 関数を呼び出します。
注釈
NdisMCmActivateVc は、MCM ドライバーが新しく作成された VC で呼び出しとメディア パラメーターを設定したか、確立された VC の呼び出しパラメーターを変更したことを NDIS に通知します。
MCM ドライバーは、VC で接続を確立した後、その VC でデータが送受信される前に NdisMCmActivateVc を呼び出す必要があります。 この呼び出しは、ミニポート ドライバーが NIC を VC で転送する準備ができたことを NDIS に通知します。
クライアントによって開始される発信呼び出しの場合、MCM ドライバーは通常、 NdisMCmMakeCallComplete で送信 呼び出しの完了を NDIS に通知する前に、リモート ノードとのネゴシエートされた契約またはスイッチでの正常な呼び出しセットアップを示すハンドシェイクに従って NdisMCmActivateVc を呼び出します。 着信呼び出しの場合、MCM ドライバーは通常 、NdisMCmCreateVc を 正常に呼び出した後、呼び出す前に NdisMCmActivateVc を 呼び出します NdisMCmDispatchIncomingCall。
ドライバーライターは、MCM ドライバーが送信および着信呼び出しの接続を設定するコンテキストでドライバーが呼び出す (内部) MiniportCoActivateVc 関数を持っているかどうかを判断します。
接続の間、MCM ドライバーは、ネットワーク変更の条件として、またはクライアントが NdisClModifyCallQoS を呼び出すたびに、呼び出しパラメーターを変更できます。 MCM ドライバーは、新しく変更された呼び出しパラメーターに従って VC で転送を続行できる場合は、新しい値への呼び出しパラメーターに関して維持する状態を更新する必要があります。 アクティブな VC の呼び出しパラメーターの変更を NDIS に通知するには、 NdisMCmActivateVc を呼び出す必要があります。 それ以外の場合、MCM ドライバーは次のいずれかを実行できます。
- クライアントの要求を失敗した後に NdisMCmDeactivateVc を呼び出して、VC の QoS またはその他の呼び出しパラメーターを、ミニポート ドライバーが VC で転送を続行できない状態に変更します。
- 呼び出しパラメーターを以前に受け入れられた状態に復元し、変更を要求したクライアントに通知し、VC でのデータ転送を続行する準備を整えます。 この場合、クライアントには、復元された呼び出しパラメーターを受け入れるか、それらを拒否して VC の終了を開始するオプションがあります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisMCmActivateVc (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisMCmActivateVc (NDIS 5.1)」を参照) でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | ndis.h (Ndis.h を含む) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 | Irql_MCM_Function(ndis) |