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 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 |
| Versione UMDF minima | 2.33 |
| Intestazione | netadapter.h (include netadaptercx.h) |