NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED (netadapter.h)

Artikel
05/23/2024

Fungsi NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED menginisialisasi struktur NET_ADAPTER_RX_CAPABILITIES untuk adaptor bersih yang ingin menentukan alokasi dan lampiran penerimaan buffer yang dikelola sistem operasi, tetapi bukan penggunaan pemetaan memori DMA.

Sintaks

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
  [_In_]  SIZE_T                      MaximumFrameSize,
  [_In_]  SIZE_T                      MaximumNumberOfQueues
);

Parameter

[_Out_] RxCapabilities

Penunjuk ke struktur NET_ADAPTER_RX_CAPABILITIES yang dialokasikan driver.

[_In_] MaximumFrameSize

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

[_In_] MaximumNumberOfQueues

Jumlah maksimum antrean terima yang didukung adaptor.

Mengembalikan nilai

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 untuk menginisialisasi struktur NET_ADAPTER_RX_CAPABILITIES jika ingin sistem operasi melakukan alokasi dan lampiran buffer penerimaan, tetapi tidak memerlukan pemetaan memori DMA. Dengan memanggil fungsi ini, anggota AllocationMode struktur kemampuan Rx diatur ke NetRxFragmentBufferAllocationModeSystem dan anggota AttachmentMode diatur ke NetRxFragmentBufferAttachmentModeSystem. Karena driver tidak menentukan kemampuan DMA dalam hal ini, fungsi ini juga mengatur anggota MappingRequirement ke NetMemoryMappingRequirementNone.