función NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA (netadapter.h)
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 |