PCONFIGURE_ADAPTER_CHANNEL fungsi panggilan balik (wdm.h)

  • Artikel

Rutinitas ConfigureAdapterChannel memanggil fungsi kustom yang diimplementasikan oleh pengontrol DMA yang diwakili oleh objek adaptor.

Sintaks

PCONFIGURE_ADAPTER_CHANNEL PconfigureAdapterChannel;

NTSTATUS PconfigureAdapterChannel(
  [in] PDMA_ADAPTER DmaAdapter,
  [in] ULONG FunctionNumber,
  [in] PVOID Context
)
{...}

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] FunctionNumber

Jumlah fungsi kustom yang akan dipilih. Untuk informasi lebih lanjut, lihat bagian Keterangan.

[in] Context

Penunjuk ke parameter konfigurasi untuk fungsi kustom yang ditentukan oleh FunctionNumber. Fungsi ini diimplementasikan oleh pengontrol DMA dan dapat diakses oleh driver perangkat melalui objek adaptor. Pengontrol DMA dan driver perangkat harus menyetujui arti dari parameter konfigurasi ini. Data yang dituju konteks buram ke sistem operasi.

Mengembalikan nilai

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

Mengembalikan nilai Deskripsi
STATUS_NOT_IMPLEMENTED
 Ekstensi DMA tidak mengimplementasikan fungsi yang ditentukan oleh FunctionNumber.

Keterangan

ConfigureAdapterChannel bukan 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.

Gunakan ConfigureAdapterChannel hanya untuk adaptor DMA sistem. Jangan gunakan rutinitas ini untuk adaptor bus-master.

Pengontrol DMA sistem tertentu mungkin memiliki fitur perangkat keras khusus yang dapat diakses driver perangkat melalui satu set atau beberapa fungsi kustom. Pengontrol mungkin menerapkan lebih dari satu fungsi kustom, dalam hal ini setiap fungsi diidentifikasi oleh nomor fungsi yang berbeda. Fungsi-fungsi ini mengabstraksi fitur perangkat keras DMA sehingga fungsi yang sama dapat didukung pada platform perangkat keras yang berbeda.

Biasanya, fungsi kustom menetapkan informasi status di pengontrol DMA untuk mengonfigurasi fitur perangkat keras untuk digunakan dalam transfer DMA berikutnya.

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

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter