NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA (netadapter.h)

Artikel
03/09/2023

Fungsi NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA menginisialisasi struktur NET_ADAPTER_RX_CAPABILITIES untuk adaptor bersih yang ingin menentukan alokasi dan lampiran penerimaan buffer yang dikelola sistem operasi, serta DMA untuk pemetaan memori.

Sintaks

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES  *RxCapabilities,
  [_In_]  NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities,
  [_In_]  SIZE_T                       MaximumFrameSize,
  [_In_]  SIZE_T                       MaximumNumberOfQueues
);

Parameter

[_Out_] RxCapabilities

Penunjuk ke struktur NET_ADAPTER_RX_CAPABILITIES yang dialokasikan driver.

[_In_] DmaCapabilities

Penunjuk ke struktur NET_ADAPTER_DMA_CAPABILITIES yang dialokasikan driver dan diinisialisasi.

[_In_] MaximumFrameSize

Ukuran bingkai maksimum, dalam byte, yang dapat diterima adaptor.

[_In_] MaximumNumberOfQueues

Jumlah maksimum antrean terima yang didukung adaptor.

Nilai kembali

Tidak ada

Keterangan

Fungsi ini adalah salah satu dari tiga fungsi yang mungkin untuk dipanggil untuk menginisialisasi struktur NET_ADAPTER_RX_CAPABILITIES . Driver klien mana yang harus memanggil tergantung pada bagaimana ia ingin mengalokasikan menerima buffer dan jika ingin menggunakan DMA.

Driver klien harus memanggil NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA untuk menginisialisasi struktur NET_ADAPTER_RX_CAPABILITIES jika ingin sistem operasi melakukan alokasi dan lampiran buffer penerima, dan jika juga ingin menggunakan DMA di jalur data penerimanya. Dengan memanggil fungsi ini, anggota AllocationMode struktur kemampuan Rx diatur ke NetRxFragmentBufferAllocationModeSystem dan anggota AttachmentMode diatur ke NetRxFragmentBufferAttachmentModeSystem.

Sebelum memanggil NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA, driver harus telah mengalokasikan struktur NET_ADAPTER_DMA_CAPABILITIES dan menginisialisasinya dengan NET_ADAPTER_DMA_CAPABILITIES_INIT. Struktur kemampuan DMA ini kemudian ditetapkan ke anggota DmaCapabilities dari struktur NET_ADAPTER_RX_CAPABILITIES .