PGET_DMA_ALIGNMENT fungsi panggilan balik (wdm.h)
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) |