NdisMCmAddPartyComplete マクロ (ndis.h)
NdisMCmAddPartyComplete は、MCM ドライバーが以前にNDIS_STATUS_PENDING返したクライアントの要求の最終状態を返し、確立されたマルチポイント VC にパーティを追加します。
構文
void NdisMCmAddPartyComplete(
_S_,
_H_,
_C_,
_P_
);
パラメーター
_S_
MCM ドライバーのアドイン操作の最終的な状態 (NDIS_STATUS_SUCCESSまたはNDIS_STATUS_PENDINGを除く任意のNDIS_STATUS_XXX) を指定します。
_H_
パーティを識別するハンドルを指定します。 MCM ドライバーは、このハンドルを ProtocolCmAddParty 関数の入力パラメーターとして取得しました。
_C_
呼び出し元によって割り当てられた常駐コンテキスト領域へのハンドルを指定します。この領域では、アドイン パーティ操作が成功した場合に MCM ドライバーがパーティ固有の状態情報を保持します。 それ以外の場合、Status がNDIS_STATUS_SUCCESS以外の場合は NDIS によって無視されるため、このパラメーターは NULL にすることができます。
_P_
クライアントによって最初に指定された呼び出し パラメーターを含 むCO_CALL_PARAMETERS型の構造体へのポインター。
戻り値
なし
解説
MCM ドライバーの ProtocolCmAddParty 関数がNDIS_STATUS_PENDINGを返す場合、ドライバーは NdisMCmAddPartyComplete を後で呼び出して、マルチポイント VC でのパーティの追加の試行が正常に完了したか、MCM ドライバーによって決定されたエラー状態で完了したことをクライアントと NDIS に通知する必要があります。
基になるネットワーク メディアは、クライアントがマルチポイント VC でパーティごとのトラフィック パラメーターを指定できるかどうかを決定します。
基になるネットワーク メディアがマルチポイント VC でパーティごとのトラフィック パラメーターをサポートしていない場合、クライアントがその VC に対して既に確立されているトラフィック パラメーターと一致しない CallParameters で仕様を持つパーティを追加しようとするたびに、MCM ドライバーは次のいずれかを実行できます。
- マルチポイント VC にパーティが正常に追加されたときに、マルチポイント VC に対して既に確立されているトラフィック パラメータをリセットします。
- 新しいパーティが正常に追加されたときに、VC に既に存在するすべてのパーティのトラフィック パラメータを変更します。
- 新しいパーティを追加する要求を拒否します。 (この代替方法では、 クライアントが NdisClMakeCall を使用してマルチポイント VC のトラフィック パラメーターを設定し、指定されたマルチポイント VC に対する NdisClAddParty の後続の呼び出しごとに同じトラフィック パラメーターを指定することを暗黙的に強制します)。
NdisMCmAddPartyComplete を呼び出すと、NDIS はクライアントの を呼び出します。 ProtocolClAddPartyComplete 関数。
統合された呼び出し管理サポートを提供する接続指向ミニポート ドライバーのみが NdisMCmAddPartyComplete を呼び出すことができます。 スタンドアロン呼び出しマネージャーは、プロトコル ドライバーとして NDIS に登録し、代わりに NdisCmAddPartyComplete を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisMCmAddPartyComplete (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisMCmAddPartyComplete (NDIS 5.1)」を参照) でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | ndis.h (Ndis.h を含む) |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 | Irql_MCM_Function(ndis) |