OID_PM_GET_PROTOCOL_OFFLOAD
Un controlador de exceso emite una solicitud de método OID de OID_PM_GET_PROTOCOL_OFFLOAD para obtener la configuración de parámetros para una descarga de protocolo de baja alimentación desde un adaptador de red.
El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene inicialmente un puntero a un identificador de descarga de protocolo ULONG. Después de una devolución correcta de la solicitud del método OID, el miembro InformationBuffer de la estructura de NDIS_OID_REQUEST contiene un puntero a una estructura de NDIS_PM_PROTOCOL_OFFLOAD .
Observaciones
Los controladores de protocolo NDIS 6.20 y versiones posteriores usan OID_PM_GET_PROTOCOL_OFFLOAD método OID para recuperar la configuración de parámetros para una descarga de protocolo de baja energía desde un adaptador de red.
El búfer de información debe apuntar a un identificador de descarga de protocolo de tipo ULONG. NDIS establece este identificador de descarga de protocolo en el miembro ProtocolOffloadId de la estructura de NDIS_PM_PROTOCOL_OFFLOAD cuando NDIS envió la solicitud OID de OID_PM_ADD_PROTOCOL_OFFLOAD anterior al adaptador de red subyacente.
El controlador de minipuerto devuelve uno de los siguientes códigos de estado para la solicitud:
NDIS_STATUS_SUCCESS
Los datos solicitados se recuperaron correctamente. El búfer de información contiene la estructura NDIS_PM_PROTOCOL_OFFLOAD correspondiente.
NDIS_STATUS_PENDING
La solicitud está pendiente de finalización. El código de estado final y los resultados se pasarán al controlador de finalización de solicitudes OID del autor de la llamada.
NDIS_STATUS_INVALID_PARAMETER
El identificador de descarga del protocolo especificado no era válido.
NDIS_STATUS_BUFFER_TOO_SHORT
El búfer de información era demasiado corto. NDIS establece los datos. QUERY_INFORMATION. BytesNeeded miembro de la estructura NDIS_OID_REQUEST al tamaño mínimo del búfer necesario.
NDIS_STATUS_NOT_SUPPORTED
La versión NDIS del controlador de minipuerto está por debajo de la 6.20.
NDIS_STATUS_FAILURE
Error en la solicitud por motivos distintos de los motivos anteriores.
Requisitos
Versión |
Compatible con NDIS 6.20 y versiones posteriores. Obligatorio para los conductores de minipuerto. (Vea la sección Comentarios.) |
Encabezado |
Ntddndis.h (include Ndis.h) |