OID_802_3_DELETE_MULTICAST_ADDRESS
Como solicitud establecida, los controladores de protocolo NDIS y de exceso usan el OID de OID_802_3_DELETE_MULTICAST_ADDRESS para eliminar una dirección de multidifusión agregada previamente de la lista de direcciones de multidifusión de un adaptador de miniport. La dirección de multidifusión es una matriz de 6 bytes. La eliminación de una dirección deshabilita esa dirección para que ya no pueda recibir paquetes de multidifusión.
Información de versión
Controladores de miniporte NDIS 6.0 y versiones posteriores
No solicitado.
Observaciones
El miembro InformationBuffer de la estructura de NDIS_OID_REQUEST contiene la dirección de 6 bytes que se va a eliminar de la lista de direcciones de multidifusión.
La solicitud de OID de OID_802_3_DELETE_MULTICAST_ADDRESS solo puede eliminar una dirección. Para eliminar más de una dirección, el controlador de protocolo debe emitir varias solicitudes de OID de OID_802_3_DELETE_MULTICAST_ADDRESS.
Los controladores de miniporte NDIS no reciben esta solicitud de OID directamente. En su lugar, NDIS consolida cada secuencia de OID_802_3_ADD_MULTICAST_ADDRESS y OID_802_3_DELETE_MULTICAST_ADDRESS solicitudes OID en una única solicitud de OID de OID_802_3_MULTICAST_LIST .
Para reemplazar o eliminar toda la lista de multidifusión, el controlador de protocolo puede usar la solicitud de OID de OID_802_3_MULTICAST_LIST .
Para agregar una dirección a la lista, el controlador de protocolo puede usar la solicitud de OID de OID_802_3_ADD_MULTICAST_ADDRESS .
El controlador de protocolo sobreagreido puede agregar varias veces una dirección de multidifusión determinada mediante el envío de varias solicitudes de OID de OID_802_3_ADD_MULTICAST_ADDRESS . Si NDIS se realiza correctamente la primera solicitud de adición de una dirección de multidifusión determinada, NDIS realizará correctamente todas las solicitudes de adición posteriores de esa dirección. Para eliminar una dirección de multidifusión que se agregó más de una vez, el controlador de sobresalto debe eliminar la dirección el mismo número de veces que agregó la dirección.
Códigos de estado de devolución
La función MiniportOidRequest del controlador miniportador devuelve uno de los siguientes valores para esta solicitud:
| Término | Descripción |
|---|---|
NDIS_STATUS_SUCCESS |
El controlador de minipuerto completó la solicitud correctamente. |
NDIS_STATUS_PENDING |
El controlador de minipuerto completará la solicitud de forma asincrónica. Después de que el controlador de miniporte haya completado todo el procesamiento, debe realizarse correctamente la solicitud llamando a la función NdisMOidRequestComplete , pasando NDIS_STATUS_SUCCESS para el parámetro Status . |
NDIS_STATUS_NOT_ACCEPTED |
El controlador de minipuerto se está restableciendo. |
NDIS_STATUS_REQUEST_ABORTED |
El controlador de minipuerto detuvo el procesamiento de la solicitud. Por ejemplo, NDIS llamó a la función MiniportResetEx . |
Requisitos
Encabezado |
Ntddndis.h (include Ndis.h) |