NdisClMakeCall 関数 (ndis.h)

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

NdisClMakeCall は、クライアントによって作成された VC に対する発信呼び出しを設定します。

構文

NDIS_STATUS NdisClMakeCall(
  [in]            NDIS_HANDLE         NdisVcHandle,
  [in, out]       PCO_CALL_PARAMETERS CallParameters,
  [in, optional]  NDIS_HANDLE         ProtocolPartyContext,
  [out, optional] PNDIS_HANDLE        NdisPartyHandle
);

パラメーター

[in] NdisVcHandle

NdisCoCreateVc をする前の呼び出しによって返されるハンドルを指定します。

[in, out] CallParameters

呼び出し元がこの接続の属性 (呼び出しのターゲットのアドレス、待機時間、帯域幅、サービス品質など) を指定した CO_CALL_PARAMETERS 型の構造体へのポインター (通話マネージャーでサポートされているネットワークメディアとアドレスファミリで QoS 仕様が許可されている場合)。

[in, optional] ProtocolPartyContext

必要に応じて、クライアントがマルチポイント VC の初期パーティーのパーティごとの状態を維持する常駐コンテキスト領域に対して呼び出し元が指定したハンドルを指定します。指定された VC がマルチポイント接続 表さない場合、このパラメーターは NULL です。マルチポイント VC の場合、NDIS は、この特定のパーティに影響を与える後続のすべての呼び出しで、クライアントの ProtocolClXxx 関数にこのハンドルを渡します。

[out, optional] NdisPartyHandle

呼び出し元が指定した変数へのポインター。通常は呼び出し元によって割り当てられたパーティーコンテキスト領域で、送信呼び出しを設定する要求が成功した場合に、NDIS はマルチポイント接続への初期パーティを表すハンドルを返します。 ProtocolPartyContext が NULL 場合、この変数は通常、クライアントの VC コンテキスト領域で、発信呼び出しのセットアップの完了時に NULL もに設定されます。

戻り値

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

備考

NdisClMakeCall 、クライアントによって開始される発信呼び出し用に、クライアントによって作成された VC の属性を設定します。クライアントは、送信呼び出しを試行する前に、NdisCoCreateVc を使用して VC を設定する必要があります。

NdisClMakeCall を呼び出すと、NDIS は、指定された NdisVcHandleをクライアントが共有する呼び出しマネージャーの ProtocolCmMakeCall 関数にこの要求を転送します。 CM は、CallParameters で指定されたデータ 検証する役割を担います。これは、関連するネットワークコンポーネントとのネゴシエート中にこのクライアントが提供するデータを変更でき、クライアントが NdisClMakeCall に最初に与えたのとは異なるトラフィックパラメーター返すことができます。クライアントの ProtocolClMakeCallComplete 関数は、変更された呼び出しパラメーターが発生した場合は受け入れるか、CM の提案された呼び出しパラメーターが許容できない場合に呼び出しを破棄する役割を担います。

そのため、CallParameters のデータは、少なくとも通話のセットアップ期間中、通話マネージャーが使用できる状態を維持する必要があります。 NdisClMakeCall がNDIS_STATUS_PENDINGを返すとき、クライアントはこのバッファー 解放できません。 ProtocolClMakeCallComplete 関数が呼び出されるまで、このクライアント割り当てリソースの解放を延期する必要があります。

NdisClMakeCall マルチポイント接続を設定する場合、基になるネットワークメディアがパーティごとのトラフィックパラメーターをサポートしていない限り、クライアントは特定の VC のトラフィックパラメーターをグローバルに確立します。

クライアントの ProtocolClMakeCallComplete 関数は、NdisPartyHandle で返されたハンドルを使用する前に、NDIS_STATUS_SUCCESSの入力状態 確認する必要があります。呼び出しマネージャーがマルチポイント接続で呼び出しを設定する要求に失敗した場合、このクライアント指定変数の値は無効です。

必要条件

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

次の方法で共有

NdisClMakeCall 関数 (ndis.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース