función NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED (netadapter.h)

  • Artículo

La función NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED 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 controlador y los datos adjuntos.

Sintaxis

void NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES      *RxCapabilities,
  [_In_]  PFN_NET_ADAPTER_RETURN_RX_BUFFER EvtAdapterReturnRxBuffer,
  [_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_] EvtAdapterReturnRxBuffer

Puntero a la función de devolución de llamada EVT_NET_ADAPTER_RETURN_RX_BUFFER del controlador cliente. Para obtener más información, vea la sección Comentarios.

[_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_DRIVER_MANAGED para inicializar su estructura de NET_ADAPTER_RX_CAPABILITIES si desea realizar la asignación de búfer de recepción manual y los datos adjuntos. Al llamar a esta función, el miembro AllocationMode de la estructura rx capabilities se establece en NetRxFragmentBufferAllocationModeDriver y el miembro AttachmentMode se establece en NetRxFragmentBufferAttachmentModeDriver. En este caso, también debe proporcionar un puntero a su función de devolución de llamada EVT_NET_ADAPTER_RETURN_RX_BUFFER en la estructura para que el sistema operativo invoque una vez que el sistema haya terminado con el búfer de recepción.

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_SYSTEM_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA