funzione NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED (netadapter.h)

  • Articolo

La funzione NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED inizializza una struttura NET_ADAPTER_RX_CAPABILITIES per un adattatore net che desidera specificare l'allocazione e l'allegato del buffer di ricezione gestiti dal sistema operativo, ma non l'uso del mapping di memoria DMA.

Sintassi

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
  [_In_]  SIZE_T                      MaximumFrameSize,
  [_In_]  SIZE_T                      MaximumNumberOfQueues
);

Parametri

[_Out_] RxCapabilities

Puntatore a una struttura di NET_ADAPTER_RX_CAPABILITIES allocata dal driver.

[_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 per inizializzare la struttura NET_ADAPTER_RX_CAPABILITIES se vuole che il sistema operativo esegua l'allocazione del buffer di ricezione e l'allegato, ma non richieda il mapping della memoria DMA. Chiamando questa funzione, il membro AllocationMode della struttura delle funzionalità Rx è impostato su NetRxFragmentBufferAllocationModeSystem e il membro AttachmentMode è impostato su NetRxFragmentBufferAttachmentModeSystem. Poiché il driver non specifica le funzionalità DMA in questo caso, questa funzione imposta anche il membro MappingRequirement su NetMemoryMappingRequirementNone.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1,25
Intestazione netadapter.h (include netadaptercx.h)

Vedi anche

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA