struktur DMA_COMMON_BUFFER_EXTENDED_CONFIGURATION (wdm.h)

  • Artikel

Menentukan konfigurasi yang menjelaskan lebih lanjut batasan dan fitur saat membuat buffer umum. Driver dapat menyediakan array struktur DMA_COMMON_BUFFER_EXTENDED_CONFIGURATION dalam rutinitas panggilan balik CreateCommonBufferFromMdl .

Sintaks

typedef struct _DMA_COMMON_BUFFER_EXTENDED_CONFIGURATION {
  DMA_COMMON_BUFFER_EXTENDED_CONFIGURATION_TYPE ConfigType;
  union {
    struct {
      PHYSICAL_ADDRESS MinimumAddress;
      PHYSICAL_ADDRESS MaximumAddress;
    } LogicalAddressLimits;
    struct {
      ULONGLONG Offset;
      ULONG     Length;
    } SubSection;
    DMA_COMMON_BUFFER_EXTENDED_CONFIGURATION_ACCESS_TYPE HardwareAccessType;
    ULONGLONG                                            Reserved[4];
  };
} DMA_COMMON_BUFFER_EXTENDED_CONFIGURATION, *PDMA_COMMON_BUFFER_EXTENDED_CONFIGURATION;

Anggota

ConfigType

Nilai yang diketik DMA_COMMON_BUFFER_EXTENDED_CONFIGURATION_TYPE yang menunjukkan jenis konfigurasi buffer umum yang diperluas instans ini.

LogicalAddressLimits

Ketika ConfigType adalah CommonBufferConfigTypeLogicalAddressLimits, menjelaskan batas alamat logis untuk buffer umum yang dibuat.

LogicalAddressLimits.MinimumAddress

Menyediakan alamat logis awal minimum (inklusif) dari buffer umum yang dibuat.

LogicalAddressLimits.MaximumAddress

Menyediakan alamat logis akhir maksimum (inklusif) dari buffer umum yang dibuat.

SubSection

Ketika ConfigType adalah CommonBufferConfigTypeSubSection, menjelaskan subbagian dalam MDL cadangan yang harus digunakan untuk mendukung buffer umum yang dibuat.

Subbagian hanya boleh dimuat dalam satu MDL dalam rantai MDL.

SubSection.Offset

Menyediakan offset ke dalam MDL untuk menunjukkan alamat awal buffer umum. Harus diratakan halaman.

SubSection.Length

Menyediakan panjang subbagian buffer umum. Harus diratakan halaman.

HardwareAccessType

Ketika ConfigType adalah CommonBufferConfigTypeHardwareAccessPermissions, ini adalah nilai yang diketik DMA_COMMON_BUFFER_EXTENDED_CONFIGURATION_ACCESS_TYPE yang menjelaskan izin akses perangkat keras untuk buffer umum yang dibuat.

Pembuatan buffer umum gagal jika jenis akses tidak dimungkinkan pada sistem. ReadOnly dan WriteOnly hanya diizinkan jika Adaptor DMA menggunakan Remapping DMA.

Reserved[4]

Bidang ini tidak digunakan.

Keterangan

Konfigurasi yang diperluas adalah parameter opsional untuk rutinitas panggilan balik CreateCommonBufferFromMdl .

Jika tidak ada konfigurasi yang diperluas yang disediakan, pembuatan buffer umum menggunakan seluruh MDL sebagai memori cadangan, dengan alamat logis minimum nol dan alamat logis maksimum yang ditentukan oleh DMA_ADAPTER digunakan.

Persyaratan

Persyaratan Nilai
Server minimum yang didukung Windows Server 2022
Header wdm.h

Lihat juga

enumerasi DMA_COMMON_BUFFER_EXTENDED_CONFIGURATION_TYPE

enumerasi DMA_COMMON_BUFFER_EXTENDED_CONFIGURATION_ACCESS_TYPE

rutinitas panggilan balik PCREATE_COMMON_BUFFER_FROM_MDL