funzione NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED (netadapter.h)

  • Articolo

La funzione NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED inizializza una struttura NET_ADAPTER_RX_CAPABILITIES per una scheda net che vuole specificare l'allocazione e l'allegato del buffer di ricezione gestito 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 client EVT_NET_ADAPTER_RETURN_RX_BUFFER. Per altre informazioni, vedere la sezione Osservazioni.

[_In_] MaximumFrameSize

Dimensioni massime 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 dal modo in cui vuole allocare buffer di ricezione e se vuole usare DMA.

Il driver client deve chiamare NET_ADAPTER_RX_CAPABILITIES_INIT_DRIVER_MANAGED per inizializzare la struttura NET_ADAPTER_RX_CAPABILITIES se si vuole eseguire l'allocazione e l'allegato del buffer di ricezione manuale. Chiamando questa funzione, il membro AllocazioneMode della struttura delle funzionalità Rx è impostato su NetRxFragmentBufferAllocationModeDriver e il membro AttachmentMode è impostato su NetRxFragmentBufferAttachmentModeDriver. In questo caso, deve inoltre 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
Intestazione netadapter.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL

Vedi anche

NET_ADAPTER_RX_CAPABILITIES

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA