OID_802_3_DELETE_MULTICAST_ADDRESS
セット要求として、NDIS および上位のプロトコル ドライバーは、OID_802_3_DELETE_MULTICAST_ADDRESS OID を使用して、 ミニポート アダプターのマルチキャスト アドレス リストから、 以前に追加したマルチキャスト アドレスを削除します。 マルチキャスト アドレスは 6 バイトの配列です。 アドレスを削除すると、そのアドレスが無効になるため、マルチキャスト パケットを受信できなくなります。
バージョン情報
NDIS 6.0 以降のミニポート ドライバー
要求されていません。
解説
NDIS_OID_REQUEST 構造の InformationBuffer メンバーには、マルチキャスト アドレス リストから削除する 6 バイト のアドレスが含まれています。
OID_802_3_DELETE_MULTICAST_ADDRESS OID 要求で削除できるアドレスは 1 つだけです。 複数のアドレスを削除するには、プロトコル ドライバーが複数の OID_802_3_DELETE_MULTICAST_ADDRESS OID 要求を発行する必要があります。
NDIS ミニポート ドライバーは、この OID 要求を直接受信しません。 その代わりに、NDIS は、OID_802_3_ADD_MULTICAST_ADDRESS と OID_802_3_DELETE_MULTICAST_ADDRESS OID 要求の各シーケンスを単一の OID_802_3_MULTICAST_LIST OID 要求に統合します。
プロトコル ドライバーは、マルチキャスト リスト全体を置き換えたり削除したりするには、OID_802_3_MULTICAST_LIST OID 要求を使用できます。
リストにアドレスを追加するには、プロトコル ドライバーは、OID_802_3_ADD_MULTICAST_ADDRESS OID 要求を使用できます。
上位のプロトコル ドライバーは、OID_802_3_ADD_MULTICAST_ADDRESS OID 要求を複数回送ることで、指定したマルチキャスト アドレスを複数回追加することができます。 NDIS が特定のマルチキャスト アドレスの最初の追加要求に成功した場合、NDIS は、そのアドレスに対するそれ以降のすべての追加要求に成功します。 複数回追加されたマルチキャスト アドレスを削除するには、上位のドライバーは、アドレスを追加したのと同じ回数だけアドレスを削除する必要があります。
状態コードを返す
ミニポート ドライバーの MiniportOidRequest 関数は、この要求に対して次のいずれかの値を返します:
用語 | 説明 |
---|---|
NDIS_STATUS_SUCCESS |
ミニポート ドライバーが要求を正常に完了しました。 |
NDIS_STATUS_PENDING |
ミニポート ドライバーは、非同期的に要求を完了します。 ミニポート ドライバーは、すべての処理を完了した後、 NdisMOidRequestComplete 関数を呼び出して要求を成功させ、 Status パラメーターの NDIS_STATUS_SUCCESS を渡す必要があります。 |
NDIS_STATUS_NOT_ACCEPTED |
ミニポート ドライバーがリセット中です。 |
NDIS_STATUS_REQUEST_ABORTED |
ミニポート ドライバーが要求の処理を停止しました。 例えば、NDIS は、 MiniportResetEx 関数を呼び出しました。 |
要件
ヘッダー |
Ntddndis.h (Ndis.h を含む) |