función NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED (netadapter.h)
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 |
Versión mínima de UMDF | 2,33 |
Encabezado | netadapter.h (include netadaptercx.h) |