struktur DMA_ADAPTER (wdm.h)

  • Artikel

Struktur DMA_ADAPTER menjelaskan antarmuka yang ditentukan sistem ke pengontrol DMA untuk perangkat tertentu. Driver memanggil IoGetDmaAdapter untuk mendapatkan struktur ini.

Sintaks

typedef struct _DMA_ADAPTER {
  USHORT          Version;
  USHORT          Size;
  PDMA_OPERATIONS DmaOperations;
} *PADAPTER_OBJECT, DMA_ADAPTER, *PDMA_ADAPTER;

Anggota

Version

Menentukan versi struktur ini. Versi 3 dari struktur DMA_ADAPTER tersedia dimulai dengan Windows 8. Untuk versi 1 dan 2 struktur ini, anggota ini diatur ke nilai 1. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Size

Menentukan ukuran, dalam byte, dari struktur ini.

DmaOperations

Penunjuk ke struktur DMA_OPERATIONS yang berisi pointer ke fungsi adaptor DMA. Versi struktur DMA_OPERATIONS yang dituju anggota ini ditentukan oleh versi struktur DMA_ADAPTER . Dengan demikian, untuk versi 1 dari struktur DMA_ADAPTER , DmaOperations menunjuk ke versi 1 dari struktur DMA_OPERATIONS , dan sebagainya. Untuk informasi selengkapnya tentang versi struktur, lihat bagian Keterangan berikut ini.

Keterangan

Driver untuk perangkat yang menggunakan DMA untuk mentransfer data menggunakan struktur ini untuk mendapatkan alamat fungsi yang memungkinkan penggunaan pengontrol DMA. Biasanya, driver mendapatkan struktur ini dengan memanggil rutinitas IoGetDmaAdapter . Driver juga dapat memperoleh struktur ini dengan mengkueri antarmuka BUS_INTERFACE_STANDARD .

Ketika rutinitas IoGetDmaAdapter mengembalikan penunjuk ke versi 1 atau versi 2 dari struktur DMA_ADAPTER , rutinitas ini selalu mengatur anggota Versi struktur ini ke 1. Dengan demikian, penelepon tidak dapat menggunakan anggota Versi untuk membedakan antara versi 1 dan 2 dari struktur DMA_ADAPTER . Untuk informasi selengkapnya tentang cara menentukan versi struktur DMA_ADAPTER yang dikembalikan oleh rutinitas ini, lihat IoGetDmaAdapter.

Persyaratan

Persyaratan Nilai
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)

Lihat juga

BUS_INTERFACE_STANDARD

DMA_OPERATIONS

IoGetDmaAdapter