funzione NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED (netadapter.h)
La funzione NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_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 driver.
Sintassi
void NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED(
[_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
[_In_] PFN_NET_ADAPTER_RETURN_RX_BUFFER EvtAdapterReturnRxBuffer,
[_In_] SIZE_T MaximumFrameSize,
[_In_] SIZE_T MaximumNumberOfQueues
);
Parametri
[_Out_] RxCapabilities
Puntatore a una struttura di NET_ADAPTER_RX_CAPABILITIES allocata dal driver.
[_In_] EvtAdapterReturnRxBuffer
Puntatore alla funzione di callback del driver del client EVT_NET_ADAPTER_RETURN_RX_BUFFER . Per altre informazioni, vedere la sezione Osservazioni.
[_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_DRIVER_MANAGED per inizializzare la struttura NET_ADAPTER_RX_CAPABILITIES se vuole eseguire l'allocazione manuale del buffer di ricezione e l'allegato. Chiamando questa funzione, il membro AllocationMode della struttura delle funzionalità Rx è impostato su NetRxFragmentBufferAllocationModeDriver e il membro AttachmentMode è impostato su NetRxFragmentBufferAttachmentModeDriver. In questo caso, deve anche fornire un puntatore al relativo EVT_NET_ADAPTER_RETURN_RX_BUFFER funzione di callback nella struttura per il sistema operativo da richiamare al termine del buffer di ricezione.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1,25 |
| Versione UMDF minima | 2.33 |
| Intestazione | netadapter.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |