OID_PM_REMOVE_PROTOCOL_OFFLOAD
Como solicitud establecida, los controladores de protocolo y NDIS usan el OID de OID_PM_REMOVE_PROTOCOL_OFFLOAD para quitar una descarga de protocolo de administración de energía de un adaptador de red. El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene un puntero a un identificador de descarga de protocolo ULONG .
Observaciones
Los controladores de protocolo y NDIS usan el OID de OID_PM_REMOVE_PROTOCOL_OFFLOAD para quitar una descarga de protocolo del adaptador de red subyacente.
Datos . SET_INFORMATION. El miembro InformationBuffer de la estructura NDIS_OID_REQUEST debe apuntar a un valor de ULONG para un identificador de descarga de protocolo agregado anteriormente. NDIS establece este identificador de descarga de protocolo en el miembro ProtocolOffloadId de la estructura NDIS_PM_PROTOCOL_OFFLOAD cuando NDIS envió la solicitud OID de OID_PM_ADD_PROTOCOL_OFFLOAD anterior al adaptador de red subyacente.
Comentarios para los escritores de controladores de minipuerto
NDIS garantiza que el tamaño del búfer sea al menos sizeof(ULONG) y que contenga un identificador de descarga de protocolo válido. Por lo tanto, la función MiniportOidRequest de un controlador miniportador debe devolver NDIS_STATUS_SUCCESS para esta solicitud.
Nota Si el controlador de minipuerto se restablezca, su función MiniportOidRequest debe devolver NDIS_STATUS_NOT_ACCEPTED.
Códigos de estado de devolución
NDIS devuelve uno de los siguientes códigos de estado para esta solicitud:
NDIS_STATUS_SUCCESS
La descarga del protocolo se quitó correctamente.
NDIS_STATUS_PENDING
La solicitud está pendiente de finalización. NDIS pasará el código de estado final y los resultados al controlador de finalización de solicitudes OID del autor de la llamada una vez completada la solicitud.
NDIS_STATUS_INVALID_LENGTH
El búfer de información es demasiado pequeño. NDIS establece data . SET_INFORMATION. BytesNeeded miembro de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario, en bytes.
NDIS_STATUS_FILE_NOT_FOUND
El identificador de descarga del protocolo en la solicitud OID no es válido.
Requisitos
Versión |
Se admite en NDIS 6.20 y versiones posteriores. Obligatorio para los controladores de minipuerto. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |