función NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED (netadapter.h)

  • Artículo

La función NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED inicializa una estructura de NET_ADAPTER_RX_CAPABILITIES para un adaptador net que desea especificar la asignación de búferes de recepción administrada por el sistema operativo y los datos adjuntos, pero no el uso de la asignación de memoria DMA.

Sintaxis

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
  [_In_]  SIZE_T                      MaximumFrameSize,
  [_In_]  SIZE_T                      MaximumNumberOfQueues
);

Parámetros

[_Out_] RxCapabilities

Puntero a una estructura de NET_ADAPTER_RX_CAPABILITIES asignada por el controlador.

[_In_] MaximumFrameSize

Tamaño máximo del marco, en bytes, que el adaptador puede recibir.

[_In_] MaximumNumberOfQueues

Número máximo de colas de recepción que admite el adaptador.

Valor devuelto

None

Observaciones

Esta función es una de las tres posibles funciones a las que llamar para inicializar una estructura de NET_ADAPTER_RX_CAPABILITIES . La que debe llamar el controlador de cliente depende de cómo le gustaría asignar búferes de recepción y si desea usar DMA.

El controlador cliente debe llamar a NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED para inicializar su estructura de NET_ADAPTER_RX_CAPABILITIES si desea que el sistema operativo realice la asignación de búferes y los datos adjuntos, pero no requiere la asignación de memoria DMA. Al llamar a esta función, el miembro AllocationMode de la estructura rx capabilities se establece en NetRxFragmentBufferAllocationModeSystem y el miembro AttachmentMode se establece en NetRxFragmentBufferAttachmentModeSystem. Dado que el controlador no especifica las funcionalidades de DMA en este caso, esta función también establece el miembro MappingRequirement en NetMemoryMappingRequirementNone.

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1,25
Encabezado netadapter.h (include netadaptercx.h)

Consulte también

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA