NdisCmDispatchIncomingCallQoSChange 関数 (ndis.h)

[アーティクル]
08/07/2023

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)