fungsi WDF_ALIGN_SIZE_DOWN (wdfcore.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Fungsi WDF_ALIGN_SIZE_DOWN mengembalikan ukuran buffer berikutnya yang lebih rendah yang diratakan ke offset perataan yang ditentukan.

Sintaks

size_t WDF_ALIGN_SIZE_DOWN(
  [in] size_t Length,
  [in] size_t AlignTo
);

Parameter

[in] Length

Panjang, dalam byte, dari buffer memori.

[in] AlignTo

Offset perataan, dalam byte. Nilai ini harus berupa kekuatan 2, seperti 2, 4, 8, 16, dan sebagainya.

Nilai kembali

WDF_ALIGN_SIZE_DOWN mengembalikan ukuran buffer yang diratakan, dalam byte.

Keterangan

Driver dapat menggunakan WDF_ALIGN_SIZE_UP atau WDF_ALIGN_SIZE_DOWN untuk menghitung ukuran buffer yang selaras dengan offset perataan tertentu. Perhitungan ini berguna jika driver Anda harus mengalokasikan beberapa buffer yang berdekatan, jika setiap buffer harus dimulai pada batas penyelarasan alamat.

Contoh

Contoh kode berikut menerima ukuran buffer dan mengembalikan ukuran (baik ukuran saat ini atau ukuran berikutnya yang lebih rendah) yang selaras dengan batas alamat DWORD.

bufferSizeAligned = WDF_ALIGN_SIZE_DOWN(bufferSize,
                                        sizeof(DWORD));

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfcore.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.)
IRQL IRQL apa pun.

Lihat juga

WDF_ALIGN_SIZE_UP