NdisCmDispatchIncomingCallQoSChange 関数 (ndis.h)
NdisCmDispatchIncomingCallQoSChange は、そのクライアントのアクティブな接続のサービス品質を変更する要求がネットワーク経由で受信されたことをクライアントに通知します。
構文
void NdisCmDispatchIncomingCallQoSChange(
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
パラメーター
[in] NdisVcHandle
QoS の変更が要求される VC へのハンドルを指定します。 呼び出しマネージャーは、着信呼び出し用にこの接続を設定するために NdisCoCreateVc を呼び出したとき、または ProtocolCoCreateVc 関数への入力パラメーターとして、最初にこのハンドルを取得しました。
[in] CallParameters
この接続に対して、リモート ノード上のクライアントによって要求された新しい QoS を指定 する CO_CALL_PARAMETERS 型 の構造体へのポインター。
戻り値
なし
解説
スタンドアロン呼び出しマネージャーは NdisCmDispatchIncomingCallQoSChange を呼び出して、アクティブな接続で QoS を変更する要求を受信したことをクライアントに通知します。 このような CM では、アクティブコールの動的 QoS 変更がサポートされます。これは、シグナリング プロトコルに依存する QoS 自体のような機能です。
CM 自体が QoS 変更の要求を受信すると、呼び出しマネージャーは NdisCmActivateVc に適切に変更された呼び出しパラメーターを渡します。そのため、基になるミニポート ドライバーにも、提案された QoS 変更が通知されます。 基になるミニポート ドライバーが変更された呼び出しパラメーターを受け入れると仮定すると、CM は NdisCmDispatchIncomingCallQoSChange を呼び出します。
NdisCmDispatchIncomingCallQoSChange を呼び出すと、NDIS はクライアントの ProtocolClIncomingQoSChange 関数を呼び出します。 クライアントは、VC の QoS に関して維持されている状態を更新し、制御を返す場合を除き、何も行わず、VC の呼び出しパラメーターに対して提案された変更を受け入れます。 それ以外の場合、クライアントは、呼び出しを破棄することで、提案された QoS 変更を拒否します。
Ndis をプロトコル ドライバーとして登録するスタンドアロン呼び出しマネージャーのみが NdisCmDispatchIncomingCallQoSChange を呼び出すことができます。 統合された呼び出し管理サポートを提供する接続指向ミニポート ドライバーは、代わりに NdisMCmDispatchIncomingCallQoSChange を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)」を参照) でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | ndis.h (Ndis.h を含む) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 | Irql_CallManager_Function(ndis) |