estructura NET_ADAPTER_TX_CAPABILITIES (netadapter.h)
La estructura NET_ADAPTER_TX_CAPABILITIES describe las funcionalidades de transmisión de un adaptador neto.
Sintaxis
typedef struct _NET_ADAPTER_TX_CAPABILITIES {
ULONG Size;
NET_MEMORY_MAPPING_REQUIREMENT MappingRequirement;
SIZE_T PayloadBackfill;
SIZE_T MaximumNumberOfFragments;
SIZE_T FragmentBufferAlignment;
UINT32 FragmentRingNumberOfElementsHint;
SIZE_T MaximumNumberOfQueues;
NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities;
} NET_ADAPTER_TX_CAPABILITIES;
Miembros
Size
Tamaño de esta estructura, en bytes.
MappingRequirement
Valor NET_MEMORY_MAPPING_REQUIREMENT que especifica cómo debe asignar el sistema operativo los búferes de datos de transmisión.
Los controladores de UMDF deben establecer MappingRequirement en NetMemoryMappingRequirementNone.
PayloadBackfill
Cantidad de espacio, en bytes, reservado para el controlador cliente antes del inicio de la carga de cada NET_PACKET.
MaximumNumberOfFragments
Número máximo de fragmentos por paquete que el adaptador puede controlar o ((SIZE_T) - 1) si no hay ningún límite.
FragmentBufferAlignment
Alineación mínima para los fragmentos de paquetes. Este miembro debe ser una potencia de 2.
FragmentRingNumberOfElementsHint
Sugerencia que indica cuántos elementos desea el adaptador para cada búfer de anillo de NET_FRAGMENT de la cola de transmisión. Este miembro debe ser una potencia de 2.
MaximumNumberOfQueues
Número máximo de colas de transmisión que admite el adaptador.
DmaCapabilities
Puntero a una estructura de NET_DMA_CAPABILITIES asignada por el controlador e inicializada que describe las funcionalidades DMA del adaptador en la ruta de acceso de transmisión. NetAdapterCx omite este miembro si MappingRequirement no está establecido en NetMemoryMappingRequirementDmamapped.
UMDF NetAdapterCX no admite DmaCapabilities. Los controladores UMDF deben establecer este miembro en NULL.
Comentarios
Llame a una de las funciones NET_ADAPTER_TX_CAPABILITIES_INIT_XXX para inicializar esta estructura. Para obtener más información sobre cada función de inicialización, consulte los vínculos de la sección Ver también.
Una estructura de NET_ADAPTER_TX_CAPABILITIES inicializada se pasa como parámetro a NetAdapterSetDatapathCapabilities.
Requisitos
| Requisito | Value |
|---|---|
| Versión mínima de KMDF | 1.27 |
| Versión mínima de UMDF | 2,33 |
| Encabezado | netadapter.h (include netadaptercx.h) |