struktur WDF_COMMON_BUFFER_CONFIG (wdfcommonbuffer.h)

Artikel
08/08/2023

[Hanya berlaku untuk KMDF]

Struktur WDF_COMMON_BUFFER_CONFIG berisi informasi konfigurasi untuk buffer umum.

Sintaks

typedef struct _WDF_COMMON_BUFFER_CONFIG {
  ULONG Size;
  ULONG AlignmentRequirement;
} WDF_COMMON_BUFFER_CONFIG, *PWDF_COMMON_BUFFER_CONFIG;

Anggota

Size

Ukuran, dalam byte, dari struktur ini.

AlignmentRequirement

Persyaratan perataan untuk buffer umum. Nilai ini harus kurang dari batas perataan. Misalnya, Anda dapat menentukan 15 untuk batas perataan 16 byte dan 31 untuk batas perataan 32-byte. Anda juga dapat menggunakan salah satu konstanta FILE_Xxxx_ALIGNMENT yang ditentukan dalam Wdm.h.

Keterangan

Struktur WDF_COMMON_BUFFER_CONFIG digunakan sebagai input ke metode WdfCommonBufferCreateWithConfig .

Jika driver Anda menentukan persyaratan perataan yang lebih besar sehingga ukuran halaman komputer (PAGE_SIZE), alamat logis yang dikembalikan metode WdfCommonBufferGetAlignedLogicalAddress selalu selaras dengan persyaratan perataan yang ditentukan, tetapi alamat virtual yang dikembalikan metode WdfCommonBufferGetAlignedVirtualAddress mungkin tidak selaras dengan persyaratan perataan.

Jika driver Anda menentukan persyaratan perataan yang kurang dari ukuran halaman komputer, semua alamat logis dan virtual diselaraskan dengan persyaratan perataan yang ditentukan.

Untuk informasi selengkapnya tentang menentukan persyaratan penyelarasan, lihat Mengaktifkan Transaksi DMA dan Menggunakan Buffer Umum.