次の方法で共有


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

こちらもご覧ください

CO_CALL_PARAMETERS

NdisAllocateFromNPagedLookasideList

NdisClAddParty

NdisCmAddPartyComplete

NdisMCmDropPartyComplete

ProtocolClAddPartyComplete

ProtocolCmAddParty