PGET_DMA_ALIGNMENT fungsi panggilan balik (wdm.h)

  • Artikel

Rutinitas GetDmaAlignment mengembalikan persyaratan penyelarasan sistem DMA.

Sintaks

PGET_DMA_ALIGNMENT PgetDmaAlignment;

ULONG PgetDmaAlignment(
  [in] PDMA_ADAPTER DmaAdapter
)
{...}

Parameter

[in] DmaAdapter

Penunjuk ke struktur DMA_ADAPTER yang dikembalikan oleh IoGetDmaAdapter yang mewakili adaptor bus-master atau pengontrol DMA.

Nilai kembali

GetDmaAlignment mengembalikan persyaratan penyelarasan, dalam byte, dari sistem DMA. Alamat awal dan panjang buffer DMA harus kelipatan dari nilai ini.

Keterangan

GetDmaAlignment bukanlah rutinitas sistem yang dapat dipanggil langsung berdasarkan nama. Rutinitas ini hanya dapat dipanggil oleh penunjuk dari alamat yang dikembalikan dalam struktur DMA_OPERATIONS . Driver mendapatkan alamat rutinitas ini dengan memanggil IoGetDmaAdapter.

Driver dapat memanggil rutinitas ini untuk menentukan persyaratan penyelarasan untuk buffer DMA yang dialokasikannya. Nilai yang dikembalikan harus digunakan untuk mengatur bidang AlignmentRequirement di objek perangkat. Driver mungkin perlu meningkatkan nilai ini karena pembatasan perangkat keras tambahan. Untuk informasi selengkapnya, lihat Menginisialisasi Objek Perangkat.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform Desktop
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI IrqlDispatch(wdm)

Lihat juga

DEVICE_OBJECT

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter