funzione NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA (netadapter.h)
La funzione NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA inizializza una struttura NET_ADAPTER_RX_CAPABILITIES per una scheda net che desidera specificare l'allocazione e l'allegato del buffer di ricezione gestiti dal sistema operativo, nonché DMA per il mapping della memoria.
Sintassi
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
);
Parametri
[_Out_] RxCapabilities
Puntatore a una struttura di NET_ADAPTER_RX_CAPABILITIES allocata dal driver.
[_In_] DmaCapabilities
Puntatore a una struttura NET_ADAPTER_DMA_CAPABILITIES allocata dal driver e inizializzata.
[_In_] MaximumFrameSize
Dimensione massima del frame, in byte, che l'adattatore può ricevere.
[_In_] MaximumNumberOfQueues
Numero massimo di code di ricezione supportate dall'adattatore.
Valore restituito
nessuno
Osservazioni
Questa funzione è una delle tre possibili funzioni da chiamare per inizializzare una struttura NET_ADAPTER_RX_CAPABILITIES . Quale driver client deve chiamare dipende da come si desidera allocare buffer di ricezione e se si vuole usare DMA.
Il driver client deve chiamare NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA per inizializzare la struttura di NET_ADAPTER_RX_CAPABILITIES se desidera che il sistema operativo esegua l'allocazione del buffer di ricezione e l'allegato e, se desidera utilizzare DMA anche nel percorso di ricezione dei dati. Chiamando questa funzione, il membro AllocationMode della struttura delle funzionalità Rx è impostato su NetRxFragmentBufferAllocationModeSystem e il membro AttachmentMode è impostato su NetRxFragmentBufferAttachmentModeSystem.
Prima di chiamare NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA, il driver deve avere allocato una struttura NET_ADAPTER_DMA_CAPABILITIES e inizializzata con NET_ADAPTER_DMA_CAPABILITIES_INIT. Questa struttura delle funzionalità DMA viene quindi assegnata al membro DmaCapabilities della struttura NET_ADAPTER_RX_CAPABILITIES .
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1,25 |
| Intestazione | netadapter.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |