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