NdisCmDispatchIncomingDropParty 関数 (ndis.h)

  • [アーティクル]

NdisCmDispatchIncomingDropParty は、通常、呼び出しマネージャーがネットワーク経由でアクティブなマルチポイント接続を閉じる要求を受信したため、マルチポイント VC 上の特定のパーティを削除する必要があることをクライアントに通知します。

構文

void NdisCmDispatchIncomingDropParty(
  [in]           NDIS_STATUS DropStatus,
  [in]           NDIS_HANDLE NdisPartyHandle,
  [in, optional] PVOID       Buffer,
  [in]           UINT        Size
);

パラメーター

[in] DropStatus

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

[in] NdisPartyHandle

マルチポイント VC から削除するパーティを識別するハンドルを指定します。このハンドルには、他のパーティがまだ接続されている必要があります。

[in, optional] Buffer

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

[in] Size

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

戻り値

なし

解説

通常のネットワーク操作の過程で、スタンドアロンコールマネージャは ProtocolCoReceiveNetBufferLists 関数は NdisCmDispatchIncomingDropParty を呼び出し 、CloseStatus は NDIS_STATUS_SUCCESS に設定されています。これは、マルチポイント接続上のリモート クライアントが NdisClCloseCall を呼び出しているためです。

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

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

NdisPartyHandle が特定の VC の最後の残りのパーティを識別する場合、CM はを呼び出します NdisCmDispatchIncomingDropParty ではなく、 NdisCmDispatchIncomingCloseCall。

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

要件

要件 値
サポートされている最小のクライアント Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisCmDispatchIncomingDropParty (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「NdisCmDispatchIncomingDropParty (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム デスクトップ
Header ndis.h (Ndis.h を含む)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 Irql_CallManager_Function(ndis)

こちらもご覧ください

NdisClDropParty

NdisCmDispatchIncomingCloseCall NdisMCmDispatchIncomingDropParty

ProtocolClIncomingDropParty

ProtocolCoReceiveNetBufferLists