PGET_DMA_ADAPTER_INFO fungsi panggilan balik (wdm.h)

Artikel
02/29/2024

Rutinitas GetDmaAdapterInfo mengambil informasi tentang kemampuan perangkat keras saluran DMA sistem.

Sintaks

PGET_DMA_ADAPTER_INFO PgetDmaAdapterInfo;

NTSTATUS PgetDmaAdapterInfo(
  [in]      PDMA_ADAPTER DmaAdapter,
  [in, out] PDMA_ADAPTER_INFO AdapterInfo
)
{...}

Parameter

[in] DmaAdapter

Penunjuk ke struktur DMA_ADAPTER . Struktur ini adalah objek adaptor yang mewakili saluran DMA sistem driver. Penelepon memperoleh pointer ini dari panggilan sebelumnya ke rutinitas IoGetDmaAdapter .

[in, out] AdapterInfo

Penunjuk ke struktur DMA_ADAPTER_INFO yang dialokasikan penelepon. Rutin menulis informasi tentang pengontrol DMA sistem ke dalam struktur ini. Pemanggil harus mengatur anggota Versi struktur ini ke DMA_ADAPTER_INFO_VERSION1 sebelum memanggil GetDmaAdapterInfo.

Nilai kembali

GetDmaAdapterInfo mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan menyertakan kode status berikut.

Menampilkan kode	Deskripsi
STATUS_NOT_SUPPORTED	Rutinitas tidak mendukung versi struktur DMA_ADAPTER_INFO_XXX yang ditentukan.

Keterangan

GetDmaAdapterInfo bukanlah rutinitas sistem yang dapat dipanggil langsung berdasarkan nama. Rutinitas ini hanya dapat dipanggil dengan pointer dari alamat yang dikembalikan dalam struktur DMA_OPERATIONS. Driver mendapatkan alamat rutinitas ini dengan memanggil IoGetDmaAdapter dengan anggota Versi parameter DeviceDescription diatur ke DEVICE_DESCRIPTION_VERSION3. Jika IoGetDmaAdapter mengembalikan NULL, rutinitas tidak tersedia di platform Anda.

GetDmaAdapterInfo mengambil informasi berikut:

Jumlah maksimum elemen dalam daftar sebar/kumpulkan yang dapat diproses oleh pengontrol DMA dalam satu operasi sebar/kumpulkan DMA.
Lebar, dalam bit, dari alamat DMA.

Untuk informasi tentang informasi adaptor DMA yang disediakan oleh versi 1 dari struktur DMA_ADAPTER_INFO_XXX , lihat DMA_ADAPTER_INFO_V1.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 8.
Target Platform	Desktop
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
IRQL	<= DISPATCH_LEVEL

Lihat juga