NdisClModifyCallQoS 関数 (ndis.h)

[アーティクル]
02/29/2024

NdisClModifyCallQoS は、接続上のサービス品質の変更を要求します。

構文

NDIS_STATUS NdisClModifyCallQoS(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

パラメーター

[in] NdisVcHandle

クライアントが QoS を変更する VC へのハンドルを指定します。クライアントはもともと NdisCoCreateVc を呼び出してこのハンドルを取得し、最近では VC ごとの状態領域からこのハンドルを取得しました。

[in] CallParameters

呼び出し元によって要求された新しい QoS を指定するCO_CALL_PARAMETERS型の構造体へのポインター。

戻り値

NdisClModifyCallQoS がNDIS_STATUS_PENDING以外のものを返す場合、クライアントは、に対して内部呼び出しを行う必要があります。 ProtocolClModifyCallQoSComplete 関数。それ以外の場合、NDIS は、この操作が完了したときにクライアントの ProtocolClModifyCallQoSComplete 関数を呼び出します。

注釈

NdisClModifyCallQoS を呼び出すと、NDIS は CM のを呼び出します。 ProtocolCmModifyCallQoS 関数。次に、 NdisCmActivateVc を呼び出して、要求された QoS 変更が可能な場合に呼び出しパラメーターを変更するように基になるミニポートドライバーに通知します。

コールマネージャがクライアントの提案された QoS 変更を受け入れない場合、クライアントはコールに変更されていない QoS を引き続き使用することも、コールを破棄することもできます。クライアントとコールマネージャが特定のコールの QoS に同意できない場合、VC の作成者は VC の破棄を開始する責任があります。

要件

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