NdisCmAddPartyComplete 関数 (ndis.h)

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

NdisCmAddPartyComplete は、確立されたマルチポイント VC にパーティを追加するために、以前に呼び出しマネージャーがNDIS_STATUS_PENDINGを返したクライアントの要求の最終状態を返します。

構文

void NdisCmAddPartyComplete(
  [in]           NDIS_STATUS         Status,
  [in]           NDIS_HANDLE         NdisPartyHandle,
  [in, optional] NDIS_HANDLE         CallMgrPartyContext,
  [in]           PCO_CALL_PARAMETERS CallParameters
);

パラメーター

[in] Status

呼び出しマネージャーのアドイン操作の最終的な状態 (NDIS_STATUS_SUCCESSまたはNDIS_STATUS_PENDINGを除く任意のNDIS_STATUS_XXX) を指定します。

[in] NdisPartyHandle

パーティを識別するハンドルを指定します。このハンドルは、呼び出しマネージャーの ProtocolCmAddParty 関数に入力されました。

[in, optional] CallMgrPartyContext

呼び出し元によって割り当てられた常駐コンテキスト領域へのハンドルを指定します。この領域では、呼び出しマネージャーは、アドインパーティ操作が成功した場合に、パーティ固有の状態情報を保持します。それ以外の場合、このパラメーターは無視されるため 、NULL にすることができます。

[in] CallParameters

クライアントによって最初に指定された呼び出しパラメーターを含むCO_CALL_PARAMETERS型の構造体へのポインター。

戻り値

なし

解説

スタンドアロン呼び出しマネージャーの ProtocolCmAddParty 関数がNDIS_STATUS_PENDINGを返す場合、CM は、その後 NdisCmAddPartyComplete を呼び出して、マルチポイント VC でのパーティの追加試行が正常に完了したかエラーが発生したかに関係なく、クライアントと NDIS に通知する必要があります。

クライアントが、マルチポイント VC に対して既に確立されているものと一致しないトラフィックパラメーターを CallParameters で渡した場合、呼び出しマネージャーのデザイナーは、ネットワークメディアによって課される制約に従って、この条件の処理方法を決定する必要があります。可能性がある問題には次のものがあります。

基になるネットワークメディアでマルチポイント VC でこの機能がサポートされている場合は、パーティごとのトラフィックパラメーターを設定します。
CM が状態としてNDIS_STATUS_SUCCESSを使用して NdisCmAddPartyComplete を呼び出す前に、元の発信呼び出しが行われたときに VC に対して確立されたトラフィックパラメーターにクライアントが指定したトラフィックパラメーターをリセット します 。
VC のトラフィックパラメーターを変更し、現在接続されているすべてのパーティに対して、CM が Status としてNDIS_STATUS_SUCCESSを使用して NdisCmAddPartyComplete を呼び出す前に、クライアントが指定した値に変更 します 。
クライアントがパーティを追加しようとして失敗します。 (この代替方法では、クライアントが NdisClMakeCall を使用してマルチポイント VC のトラフィックパラメーターを設定し、指定されたマルチポイント VC に対する NdisClAddParty の後続の呼び出しごとに同じトラフィックパラメーターを指定することを暗黙的に強制します)。

一部の接続指向メディアの場合、トラフィックパラメーターは本質的に VC 単位であり、その結果、マルチポイント VC 上のすべての関係者で同じです。

CM が Status をNDIS_STATUS_SUCCESSに設定する場合は、明示的なハンドル (通常は、NdisCmAddPartyComplete を呼び出すときに CallMgrPartyContext として、CM によって割り当てられたパーティごとの状態領域へのポインター) を指定する必要があります。

NdisCmAddPartyComplete を呼び出すと、NDIS はクライアントのを呼び出します。 ProtocolClAddPartyComplete 関数。

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

要件

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