NdisMCmAddPartyComplete マクロ (ndis.h)

[アーティクル]
08/07/2023

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

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

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)