OID_WAN_CO_GET_INFO
El OID_WAN_CO_GET_INFO OID solicita al controlador de miniportar que devuelva información que se aplica a todas las conexiones virtuales (VCs) en su NIC. Esta información se devuelve en una estructura de NDIS_WAN_CO_INFO, definida como se indica a continuación.
typedef struct _NDIS_WAN_CO_INFO {
OUT ULONG MaxFrameSize;
OUT ULONG MaxSendWindow;
OUT ULONG FramingBits;
OUT ULONG DesiredACCM;
} NDIS_WAN_CO_INFO, *PNDIS_WAN_CO_INFO;
Los miembros de esta estructura contienen la siguiente información:
MaxFrameSize
Especifica el tamaño máximo del marco para cualquier paquete neto que el controlador de miniporte pueda enviar y recibir. Este valor debe excluir la sobrecarga del controlador de minipuerto y/o la sobrecarga PPP. Normalmente, este valor es de aproximadamente 1500.
Sin embargo, todos los controladores de miniport de CoNDIS WAN deben usar un MaxFrameSize interno de 32 bytes mayor que el valor que devuelven para este OID. Por ejemplo, un controlador de miniport de CoNDIS WAN que devuelve 1500 para este OID debe aceptar internamente y enviar hasta 1532. Este miniportador puede admitir fácilmente protocolos adicionales y puentes futuros.
MaxSendWindow
Especifica el número máximo de paquetes pendientes que el controlador de miniporte coNDIS WAN puede controlar en un VC. Este miembro debe establecerse en al menos uno.
El controlador NDISWAN usa el valor de este miembro como límite sobre el número de paquetes que envía en solicitudes de envío a la función MiniportCoSendPackets del controlador de miniporte antes de que NDISWAN contenga paquetes de envío. Estos paquetes se ponen en cola hasta que el controlador de miniporte completa un envío pendiente. Un controlador de minipuerto puede ajustar este valor dinámicamente y por VC mediante el miembro SendWindow en la estructura WAN_CO_LINKPARAMS que pasa el controlador de miniporte a NdisMCoIndicateStatus. NDISWAN usa el valor actual de SendWindow como su límite en envíos pendientes. Si el controlador de minipuerto establece SendWindow en cero, NDISWAN debe dejar de enviar paquetes para el VC determinado. Es decir, el controlador de minipuerto especifica que la ventana de envío está apagada, que, en efecto, especifica que no puede aceptar ningún paquete de NDISWAN.
Dado que un controlador de miniporte de CoNDIS WAN debe poner en cola paquetes internamente, el valor de MaxSendWindow es teóricamente max( ULONG). Sin embargo, este valor determinado por el controlador debe reflejar la velocidad de vínculo o las capacidades de hardware de la NIC. Por ejemplo, si la NIC de un controlador de miniporte siempre tiene espacio para al menos cuatro paquetes, el controlador de minipuerto establece MaxSendWindow en cuatro para que cualquier paquete entrante a MiniportCoSendPackets se pueda colocar inmediatamente en el hardware.
FramingBits
Valor de 32 bits que especifica una máscara de bits que especifica los tipos de enmarcar el controlador de minipuerto admite. El controlador de minipuerto puede especificar una combinación de los siguientes valores, mediante el operador OR binario:
RAS_FRAMING
Establezca solo si el controlador de minipuerto puede detectar tramas RAS más antiguas. Solo los controladores heredados que admitan marcos ras anteriores establecen esta marca.
RAS_COMPRESSION
Establezca solo si el controlador de minipuerto admite el esquema de compresión RAS anterior.
PPP_FRAMING
Siempre debe establecerse. Indica que el controlador de minipuerto puede detectar y admitir marcos PPP para su tipo medio.
PPP_COMPRESS_ADDRESS_CONTROL
Establezca si el controlador de minipuerto admite la compresión de campo de control y dirección PPP.
NDISWAN quitará la dirección y el campo de control si se negocia esta opción LCP. Algunos tipos medios WAN, como X.25, no admiten esta opción.
PPP_COMPRESS_PROTOCOL_FIELD
Establezca si el controlador de minipuerto admite la compresión de campo del protocolo PPP.
NDISWAN quitará un byte del campo de protocolo cuando sea aplicable si se negocia esta opción LCP.
PPP_ACCM_SUPPORTED
Establezca si el controlador de minipuerto admite la asignación asincrónica de caracteres de control. Este bit solo es válido para medios asincrónicos, como módems. Si este bit se establece, el miembro DesiredACCM debe ser válido.
PPP_MULTILINK_FRAMING
Establezca si el controlador de miniporte admite tramas de varios vínculos, tal como se especifica en IETF RFC 1717.
PPP_SHORT_SEQUENCE_HDR_FORMAT
Establezca si el controlador de minipuerto admite el formato de encabezado para el marco de varios vínculos tal como se especifica en IETF RFC 1717.
SLIP_FRAMING
Establezca si el controlador de miniporte puede detectar y admitir marcos SLIP (solo controladores de miniport asincrónico).
SLIP_VJ_COMPRESSION
Establezca si el controlador de minipuerto puede admitir la compresión de encabezado TCP/IP de Van Jacobsen para SLIP. NDISWAN admite SLIP_VJ_COMPRESSION (con 16 ranuras). Los medios asincrónicos (controladores de minipuerto serie) que admiten marcos SLIP deben establecer este bit.
Los medios asincrónicos no necesitan escribir ningún código para admitir la compresión de encabezadoS VJ. NDISWAN se encargará de ello.
SLIP_VJ_AUTODETECT
Establezca si el controlador de minipuerto puede detectar automáticamente la compresión de encabezado TCP/IP de Van Jacobsen para SLIP. NDISWAN detectará automáticamente la compresión del encabezado VJ. Los medios asincrónicos (controladores de minipuerto serie) deben establecer este bit si admiten marcos SLIP.
TAPI_PROVIDER
Establezca si el controlador de minipuerto admite los OID del proveedor de servicios TAPI. A menos que se establezca este bit, las llamadas OID de TAPI no se realizarán en el controlador de miniporte.
MEDIA_NRZ_ENCODING
Establezca si el controlador de minipuerto admite la codificación NRZ, el valor predeterminado de PPP para algunos tipos de medios, como ISDN. Este valor está reservado para uso futuro.
MEDIA_NRZI_ENCODING
Establezca si el controlador de minipuerto admite la codificación NRZI. Este valor está reservado para uso futuro.
MEDIA_NLPID
Establezca si el controlador de minipuerto tiene y puede establecer el NLPID en su marco. Este valor está reservado para uso futuro.
RFC_1356_FRAMING
Se establece si el controlador de minipuerto admite IETF RFC 1356 X.25 y marcos ISDN. Este valor está reservado para uso futuro.
RFC_1483_FRAMING
Se establece si el controlador de minipuerto admite la encapsulación de la capa de adaptación de ATM 1483 RFC 1483 DE IETF. Este valor está reservado para uso futuro.
RFC_1490_FRAMING
Se establece si el controlador de minipuerto es compatible con el marco del relé de marco RFC 1490 de IETF. Este valor está reservado para uso futuro.
NBF_PRESERVE_MAC_ADDRESS
Establezca si el controlador de minipuerto admite el marco IETF tal y como se especifica en el borrador "El protocolo de control de marcos NETBIOS PPP (NBFCP)."
SHIVA_FRAMING
Reemplazado por NBF_PRESERVE_MAC_ADDRESS.
PASS_THROUGH_MODE
Se establece si el controlador de miniporte realiza su propia trama. Si se establece esta marca, NDISWAN pasa fotogramas, no interpretados y sin modificar.
Los controladores de minipuerto deben estar en el modo de trama PPP predeterminado hasta que cada controlador de miniporte reciba una solicitud de OID_WAN_CO_SET_LINK_INFO . El controlador de minipuerto debe detectar automáticamente las tramas que afirma admitir.
Por ejemplo, los controladores de minipuerto que admiten marcos RAS antiguos deben detectar automáticamente el marco RAS del marco PPP. Si un controlador de minipuerto detecta un esquema de trama distinto del predeterminado, ese controlador de minipuerto debería cambiar automáticamente su trama a la trama recién detectada.
Una consulta posterior con OID_WAN_CO_GET_LINK_INFO debe indicar el marco detectado. Si todavía no se detecta ningún marco, Los FramingBits deben ser cero en la información de NDIS_WAN_CO_GET_LINK_INFO devuelta.
Si se llama al controlador de minipuerto WAN posteriormente con OID_WAN_CO_SET_LINK_INFO en el que el miembro FrameBits es cero, el controlador de minipuerto debe intentar detectar automáticamente la trama tras la recepción de cada fotograma.
DesiredACCM
Se negocia el mapa de caracteres de control asincrónico. Este miembro solo es relevante para los tipos de medios asincrónicos.
Requisitos
Versión |
Compatible con controladores NDIS 6.0 y NDIS 5.1 en Windows Vista. Compatible con controladores NDIS 5.1 en Windows XP. |
Encabezado |
Ntddndis.h (include Ndis.h) |