NdisMCmDispatchIncomingDropParty マクロ (ndis.h)

NdisMCmDispatchIncomingDropParty は、マルチポイント VC 上の特定のパーティを削除する必要があることをクライアントに通知します。

構文

void NdisMCmDispatchIncomingDropParty(
   _S_,
   _H_,
   _B_,
   _Z_
);

パラメーター

_S_

このパーティが削除される理由を示します。通常は、リモート パーティが接続を閉じるだけで要求した場合にNDIS_STATUS_SUCCESS。

_H_

マルチポイント VC から削除するパーティを識別するハンドルを指定します。このハンドルには、他のパーティがまだ接続されている必要があります。 MCM ドライバーは、もともと ProtocolCmAddParty 関数への入力パラメーターとしてこのハンドルを取得しました。

_B_

リモート パーティから受信した追加のプロトコル固有のデータ (存在する場合) を含む、呼び出し元によって割り当てられた常駐バッファーへのポインター。 基になるメディアに応じて、このポインターは NULL にすることができます。

_Z_

バッファーのサイズをバイト単位で指定します。 Buffer が NULL の場合は 0 です。

戻り値

なし

解説

通常のネットワーク操作の過程で、MCM ドライバーは NdisMCmDispatchIncomingDropParty を呼び出し、 CloseStatus を NDIS_STATUS_SUCCESS に設定します。これは、マルチポイント接続上のリモート クライアントが NdisClCloseCall を呼び出したためです。

ただし、MCM ドライバーは、ローカル クライアントと確立されたマルチポイント接続上の 1 つ以上のクライアント間のパスのスイッチの障害など、異常なネットワーク状態が発生した場合に、ネットワーク自体の最も近いドライバーによって決定された CloseStatus を使用して NdisMCmDispatchIncomingDropParty を呼び出すこともできます。

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

NdisPartyHandle が特定の VC の最後の残りのパーティを識別する場合、MCM ドライバーは を呼び出します NdisMCmDispatchIncomingDropParty ではなく、 NdisMCmDispatchIncomingCloseCall。

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

要件

こちらもご覧ください

MiniportInterruptDPC

NdisClDropParty

ProtocolClIncomingDropParty