PROTOCOL_CL_MODIFY_CALL_QOS_COMPLETE コールバック関数 (ndis.h)

[アーティクル]
02/07/2025

ProtocolClModifyCallQoSComplete 関数は、接続のサービス品質を動的に変更できる接続指向 NDIS クライアントによって使用されます。このようなクライアントは 、NdisClModifyCallQoSで開始する非同期操作を完了するために、ProtocolClModifyCallQoSComplete 関数を持っている必要があります。それ以外の場合、このようなプロトコルドライバーの登録 ProtocolClModifyCallQoSComplete 関数は、単に制御を返すことができます。

注PROTOCOL_CL_MODIFY_CALL_QOS_COMPLETE 型を使用して関数を宣言する必要があります。詳細については、次の例のセクションを参照してください。

構文

PROTOCOL_CL_MODIFY_CALL_QOS_COMPLETE ProtocolClModifyCallQosComplete;

void ProtocolClModifyCallQosComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE ProtocolVcContext,
  [in] PCO_CALL_PARAMETERS CallParameters
)
{...}

パラメーター

[in] Status

この VC の呼び出しパラメーターを変更するクライアントの非同期要求の最終的な状態を次のように指定します。

NDIS_STATUS_SUCCESS

QoS は、クライアントによって要求されたとおりに変更されました。

NDIS_STATUS_RESOURCES

NDIS または呼び出しマネージャーの 1 つが十分なリソースを動的に割り当てることができなかったため、QoS を変更できませんでした。

NDIS_STATUS_INVALID_DATA

クライアントが NdisClModifyCallQoS に指定 呼び出しパラメーターが無効でした。

NDIS_STATUS_FAILURE

呼び出しマネージャーは、ネットワークまたは別の接続指向ネットワークコンポーネントで障害が発生したため、QoS を変更できませんでした。

NDIS_STATUS_XXX

呼び出しマネージャーは QoS の変更に失敗し、NDIS は CM によって決定されたエラー状態をクライアントに伝達しました。

[in] ProtocolVcContext

クライアントがこの VC の着信呼び出しを受け入れた場合、クライアントが送信呼び出し要求の VC 設定するために、または ProtocolCoCreateVc 関数から VC を設定するために ndisCoCreateVc を呼び出したときに、クライアントの VC ごとのコンテキスト領域へのハンドルを指定します。

[in] CallParameters

クライアントが指定した QoS 変更を含むバッファー CO_CALL_PARAMETERS構造体へのポインター。接続がアクティブ化されたときに確立された、この VC の元の QoS (呼び出しマネージャーが復元した可能性があります)。

戻り値

何一つ

備考

ProtocolClModifyCallQoSComplete 呼び出しは、呼び出しマネージャーが、アクティブ VC のサービス品質を変更するためのクライアント側開始要求の処理を完了したことを示します。たとえば、基になるネットワークメディアが動的 QoS 変更をサポートしている場合、クライアントはアクティブな VC でいつでも変更を要求できます。

クライアントが NdisClModifyCallQoS 呼び出しに成功した場合、ProtocolClModifyCallQoSComplete は、制御を返すだけで QoS の変更を受け入れます。それ以外の場合、ProtocolClModifyCallQoSComplete は、クライアントの開発者が可能な再ネゴシエーションの数に妥当な制限を設定している限り、呼び出しマネージャーとのさらなるネゴシエーションを行うことができます。または、ProtocolClModifyCallQoSComplete は、呼び出しマネージャーが QoS の変更要求を拒否し、以前に確立された QoS がクライアントに対して受け入れられないようになったときに、NdisClCloseCall を使用して呼び出しを破棄することもできます。

の例

ProtocolClModifyCallQoSComplete 関数を定義するには、まず、定義する関数の型を識別する関数宣言を指定する必要があります。 Windows には、ドライバーの関数の種類のセットが用意されています。関数の種類を使用して関数を宣言すると、ドライバーのコード分析、静的ドライバー検証ツール (SDV)、およびその他の検証ツールをすると、エラーが検出され、Windows オペレーティングシステムのドライバーを記述するための要件になります。

たとえば、"MyClModifyCallQoSComplete" という名前の ProtocolClModifyCallQoSComplete 関数を定義するには、次のコード例に示すように PROTOCOL_CL_MODIFY_CALL_QOS_COMPLETE 型を使用します。

PROTOCOL_CL_MODIFY_CALL_QOS_COMPLETE MyClModifyCallQoSComplete;

次に、次のように関数を実装します。

_Use_decl_annotations_
VOID
 MyClModifyCallQoSComplete(
    NDIS_STATUS  Status,
    NDIS_HANDLE  ProtocolVcContext,
    PCO_CALL_PARAMETERS  CallParameters
    )
  {...}

PROTOCOL_CL_MODIFY_CALL_QOS_COMPLETE 関数の種類は、Ndis.h ヘッダーファイルで定義されています。コード分析ツールの実行時にエラーをより正確に識別するには、Use_decl_annotations 注釈を関数定義に追加してください。 Use_decl_annotations 注釈を使用すると、ヘッダーファイル内の PROTOCOL_CL_MODIFY_CALL_QOS_COMPLETE 関数型に適用される注釈が確実に使用されます。関数宣言の要件の詳細については、「ndis ドライバーのの関数の役割の種類を使用して関数を宣言するを参照してください。

Use_decl_annotationsの詳細については、「関数の動作に注釈を付ける」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (ProtocolClModifyCallQoSComplete (NDIS 5.1) を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (ProtocolClModifyCallQoSComplete (NDIS 5.1) を参照) でサポートされています。
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	ndis.h (Ndis.h を含む)
IRQL	<= DISPATCH_LEVEL

次の方法で共有