funzione NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED (netadapter.h)
La funzione NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED 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, 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'adapter.
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 e l'allegato del buffer di ricezione, ma non richiede il mapping di 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.25 |
| versione minima di UMDF | 2.33 |
| intestazione | netadapter.h (include netadaptercx.h) |