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

Vedi anche

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED