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_MULTICAST_LIST OID 要求に OID_802_3_ADD_MULTICAST_ADDRESS およびOID_802_3_DELETE_MULTICAST_ADDRESS OID 要求の各シーケンスを統合します。
プロトコル ドライバーは、マルチキャスト リスト全体を置き換えたり削除したりするために、OID_802_3_MULTICAST_LIST OID 要求を使用できます。
一覧にアドレスを追加するには、プロトコル ドライバーは、OID_802_3_ADD_MULTICAST_ADDRESS OID 要求を使用できます。
基になるプロトコル ドライバーは、複数の OID_802_3_ADD_MULTICAST_ADDRESS OID 要求を送信することで、指定されたマルチキャスト アドレスを複数回追加できます。 NDIS が特定のマルチキャスト アドレスの最初の追加要求に成功した場合、NDIS は、そのアドレスの後続のすべての追加要求に成功します。 複数回追加されたマルチキャスト アドレスを削除するには、上にあるドライバーは、アドレスを追加したのと同じ回数だけアドレスを削除する必要があります。
戻り値の状態コード
ミニポート ドライバーの ミニポートOidRequest 関数は、この要求に対して次のいずれかの値を返します。
| 用語 | 形容 |
|---|---|
NDIS_STATUS_SUCCESS |
ミニポート ドライバーが要求を正常に完了しました。 |
NDIS_STATUS_PENDING |
ミニポート ドライバーは、非同期的に要求を完了します。 ミニポート ドライバーは、すべての処理を完了した後、NdisMOidRequestComplete 関数を呼び出して要求を成功させる必要があります、状態 パラメーターの NDIS_STATUS_SUCCESS を渡します。 |
NDIS_STATUS_NOT_ACCEPTED |
ミニポート ドライバーがリセット中です。 |
NDIS_STATUS_REQUEST_ABORTED |
ミニポート ドライバーが要求の処理を停止しました。 たとえば、NDIS は、ミニポートResetEx 関数を呼び出しました。 |
必要条件
ヘッダ |
Ntddndis.h (Ndis.h を含む) |