NdisMCmDispatchIncomingCallQoSChange マクロ (ndis.h)

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

NdisMCmDispatchIncomingCallQoSChange は、そのクライアントのアクティブな接続のサービス品質を変更する要求がネットワーク経由で受信されたことをクライアントに通知します。

構文

void NdisMCmDispatchIncomingCallQoSChange(
   _H_,
   _P_
);

パラメーター

_H_

QoS の変更が要求される VC へのハンドルを指定します。 MCM ドライバーは、着信呼び出し用にこの接続を設定するために NdisMCmCreateVc を呼び出したとき、または ProtocolCoCreateVc 関数への入力パラメーターとして、このハンドルを取得しました。

_P_

この接続に対して、リモートノード上のクライアントによって要求された新しい QoS を指定する CO_CALL_PARAMETERS 型の構造体へのポインター。

戻り値

なし

解説

MCM ドライバーは NdisMCmDispatchIncomingCallQoSChange を呼び出して、アクティブな接続で QoS を変更する要求を受信したことをクライアントに通知します。このような MCM ドライバーは、アクティブな呼び出しで動的な QoS 変更をサポートします。これは、シグナリングプロトコルに依存する QoS 自体のような機能です。

MCM ドライバーは、アクティブな VC の呼び出しパラメーターを変更するたびに NdisMCmActivateVc を呼び出す必要があります。

NdisMCmDispatchIncomingCallQoSChange を呼び出すと、NDIS はクライアントの ProtocolClIncomingQoSChange 関数を呼び出します。クライアントは、VC の QoS に関して維持されている状態を更新し、制御を返す場合を除き、何も行わず、VC の呼び出しパラメーターに対して提案された変更を受け入れます。それ以外の場合、クライアントは、呼び出しを破棄することで、提案された QoS 変更を拒否します。

統合された呼び出し管理サポートを提供する接続指向ミニポートドライバーのみが NdisMCmDispatchIncomingCallQoSChange を呼び出すことができます。スタンドアロン呼び出しマネージャーは、プロトコルドライバーとして NDIS に登録し、代わりに NdisCmDispatchIncomingCallQoSChange を 呼び出します。

要件

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