función NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA (netadapter.h)

  • Artículo

La función NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA inicializa una estructura de NET_ADAPTER_RX_CAPABILITIES para un adaptador neto que desea especificar la asignación de búferes de recepción administrada por el sistema operativo y los datos adjuntos, así como DMA para la asignación de memoria.

Sintaxis

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES  *RxCapabilities,
  [_In_]  NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities,
  [_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_] DmaCapabilities

Puntero a una estructura de NET_ADAPTER_DMA_CAPABILITIES asignada por el controlador e inicializada.

[_In_] MaximumFrameSize

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

[_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 desea asignar búferes de recepción y si desea usar DMA.

El controlador cliente debe llamar a NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA para inicializar su estructura de NET_ADAPTER_RX_CAPABILITIES si desea que el sistema operativo realice la asignación de búfer y los datos adjuntos, y si también desea usar DMA en su ruta de acceso de datos de recepción. 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.

Antes de llamar a NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA, el controlador debe haber asignado una estructura de NET_ADAPTER_DMA_CAPABILITIES e inicializarla con NET_ADAPTER_DMA_CAPABILITIES_INIT. A continuación, esta estructura de funcionalidades de DMA se asigna al miembro DmaCapabilities de la estructura NET_ADAPTER_RX_CAPABILITIES .

Requisitos

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

Consulte también

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED