OID_OFFLOAD_ENCAPSULATION
Como solicitud de consulta, los controladores que usan el OID de OID_OFFLOAD_ENCAPSULATION para obtener la configuración de encapsulación de descarga de tareas actual de un adaptador de miniport subyacente. NDIS controla esta consulta de OID para controladores de minipuerto.
Como solicitud establecida, los controladores que usan el OID de OID_OFFLOAD_ENCAPSULATION para establecer la configuración de encapsulación de descarga de tareas de un adaptador de miniport subyacente. Los controladores de miniporte que admiten la descarga de tareas deben controlar esta solicitud de conjunto de OID.
Observaciones
El miembro InformationBuffer de la estructura NDIS_OID_REQUEST contiene una estructura NDIS_OFFLOAD_ENCAPSULATION .
Controladores de minipuerto
Si un controlador de minipuerto no admite la descarga y este OID, el controlador debe devolver NDIS_STATUS_NOT_SUPPORTED.
Los controladores de minipuerto deben usar el contenido de la estructura de NDIS_OFFLOAD_ENCAPSULATION para actualizar las funcionalidades de descarga tcp notificadas actualmente. Después de la actualización, el controlador de minipuerto debe notificar las funcionalidades de descarga de tareas actuales con la indicación de estado NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG . Esta indicación de estado garantiza que todos los controladores de protocolo excesivos se actualicen con la nueva información de funcionalidades.
Este OID se usa para activar todas las descargas configuradas o habilitadas, o desactivar todas las descargas (es decir, el hardware comienza a realizar las descargas). No proporciona un control preciso sobre las descargas individuales. En su lugar, OID_TCP_OFFLOAD_PARAMETERS se usa para configurar descargas individuales y también puede activarlas. Por lo general, la mayoría de las descargas de tareas TCP/IP se pueden configurar y activar con OID_TCP_OFFLOAD_PARAMETERS.
Sin embargo, la estructura de NDIS_OFFLOAD_ENCAPSULATION de este OID también cubre otros dos tipos de encapsulación que no están cubiertos por la estructura de NDIS_OFFLOAD_PARAMETERS de OID_TCP_OFFLOAD_PARAMETERS : NDIS_ENCAPSULATION_IEEE_802_3 y NDIS_ENCAPSULATION_IEEE_LLC_SNAP_ROUTED. Los controladores de minipuerto deben controlar esta diferencia en los tipos de encapsulación que están cubiertos por los diferentes identificadores de identificación.
Si el controlador de protocolo emite este OID para desactivar todas las descargas, el miembro Habilitado del miembro NDIS_OFFLOAD_ENCAPSULATION se establecerá en NDIS_OFFLOAD_SET_OFF.
Configuración de la encapsulación (controladores de protocolo)
Los controladores de protocolo establecen OID_OFFLOAD_ENCAPSULATION después de determinar los requisitos de encapsulación del sistema. Un controlador de protocolo puede determinar las funciones del adaptador de minipuerto subyacente desde la estructura de NDIS_BIND_PARAMETERS o consultando OID_TCP_OFFLOAD_CURRENT_CONFIG. El controlador de protocolo debe establecer un tipo de encapsulación que admita el adaptador de miniporte en al menos un servicio de descarga.
Si un controlador de minipuerto admite cualquier tipo de descarga que admita el tipo de encapsulación solicitado, el controlador debe devolver NDIS_STATUS_SUCCESS en respuesta a un conjunto de OID_OFFLOAD_ENCAPSULATION. De lo contrario, el controlador de minipuerto debe devolver NDIS_STATUS_INVALID_PARAMETER.
En el caso de las operaciones de envío, un controlador de protocolo puede emitir solicitudes de envío usando solo los tipos de descarga que admite el adaptador de miniporte con el tipo de encapsulación necesario. Por lo tanto, si se produce un error en una solicitud de conjunto de OID de OID_OFFLOAD_ENCAPSULATION, el controlador de protocolo no debe usar ninguna configuración de descarga en las solicitudes de envío dirigidas a ese adaptador de minipuerto.
Para las operaciones de recepción, el controlador de miniporte no debe iniciar la suma de comprobación ni los servicios de descarga de seguridad del protocolo de Internet (IPsec) hasta que reciba una solicitud de conjunto de OID de OID_OFFLOAD_ENCAPSULATION.
Obtención de la configuración de encapsulación actual (controladores de protocolo)
Un controlador de protocolo puede emitir una consulta de OID_OFFLOAD_ENCAPSULATION solo después de establecer el OID de OID_OFFLOAD_ENCAPSULATION.
NDIS responde con una estructura de NDIS_OFFLOAD_ENCAPSULATION que contiene la configuración de encapsulación actual.
Los controladores de protocolo deben estar preparados para controlar cualquier código de error de NDIS_STATUS_Xxx. Si se produce un error, el controlador de protocolo no debe intentar realizar ninguna operación de descarga dirigida al adaptador de miniporte afectado.
Consulte también
NDIS_BIND_PARAMETERS
NDIS_OFFLOAD_ENCAPSULATION
NDIS_OID_REQUEST
NDIS_STATUS_TASK_OFFLOAD_CURRENT_CONFIG
OID_TCP_OFFLOAD_CURRENT_CONFIG
Requisitos
Versión: Windows Vista y encabezado posterior: Ntddndis.h (incluye Ndis.h)