NdisCmAddPartyComplete 関数 (ndis.h)
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 の後続の呼び出しごとに同じトラフィック パラメーターを指定することを暗黙的に強制します)。
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) |