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

[アーティクル]
03/08/2024

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 の着信呼び出しを受け入れた場合に、クライアントが送信呼び出し要求または ProtocolCoCreateVc 関数の VC を設定するために NdisCoCreateVc を呼び出したときに、クライアントが最初に NDIS に提供した 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)」を参照) でサポートされています。
対象プラットフォーム	Windows
ヘッダー	ndis.h (Ndis.h を含む)
IRQL	<= DISPATCH_LEVEL