OID_PM_PROTOCOL_OFFLOAD_LIST
Como consulta, los controladores que se sobreponen pueden usar el OID de OID_PM_PROTOCOL_OFFLOAD_LIST para enumerar las descargas de protocolo que se establecen en un adaptador de red subyacente. Después de una devolución correcta de la solicitud de consulta OID, el miembro InformationBuffer de la estructura de NDIS_OID_REQUEST contiene un puntero a una lista de estructuras de NDIS_PM_PROTOCOL_OFFLOAD que describen las descargas del protocolo actualmente activo.
Observaciones
NDIS controla la consulta de controladores de minipuerto. Los controladores NDIS pueden usar el OID de OID_PM_PROTOCOL_OFFLOAD_LIST para obtener una lista de descargas de protocolo que se establecen en un adaptador de red subyacente.
Para cada estructura de NDIS_PM_PROTOCOL_OFFLOAD de la lista, NDIS establece el miembro NextProtocolOffloadOffset en el desplazamiento desde el principio del búfer de información de OID (es decir, el principio del búfer al que apunta el miembro InformationBuffer de la estructura NDIS_OID_REQUEST apunta) al principio de la siguiente estructura NDIS_PM_PROTOCOL_OFFLOAD de la lista. El desplazamiento del miembro NextProtocolOffloadOffset de la última estructura de la lista es cero.
Si no hay descargas de protocolo que se establecen en el adaptador de red, NDIS establece data . QUERY_INFORMATION. BytesEscrito miembro de la estructura de NDIS_OID_REQUEST en cero y devuelve NDIS_STATUS_SUCCESS. Los datos dentro de DATA. QUERY_INFORMATION. El miembro InformationBuffer no lo modifica NDIS.
NDIS devuelve uno de los siguientes códigos de estado para la solicitud:
NDIS_STATUS_SUCCESS
La solicitud se completó correctamente. InformationBuffer contiene un puntero a una lista de descargas de protocolo, si las hay.
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_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_FAILURE
Error en la solicitud por motivos distintos de los motivos anteriores.
Requisitos
Versión |
Compatible con NDIS 6.20 y versiones posteriores. No se solicita para los conductores de miniport. (Vea la sección Comentarios.) |
Encabezado |
Ntddndis.h (include Ndis.h) |