Fungsi PcNewDmaChannel (portcls.h)

Artikel
02/29/2024

Fungsi PcNewDmaChannel membuat objek DMA-channel baru. Fungsi ini kedaluarsa; untuk informasi selengkapnya, lihat komentar berikut.

Sintaks

PORTCLASSAPI NTSTATUS PcNewDmaChannel(
  [out]          PDMACHANNEL         *OutDmaChannel,
  [in, optional] PUNKNOWN            OuterUnknown,
  [in]           POOL_TYPE           PoolType,
  [in]           PDEVICE_DESCRIPTION DeviceDescription,
  [in]           PDEVICE_OBJECT      DeviceObject
);

Parameter

[out] OutDmaChannel

Penunjuk output untuk objek saluran DMA yang dibuat oleh fungsi ini. Parameter ini menunjuk ke variabel pointer yang dialokasikan penelepon tempat fungsi menghasilkan referensi ke objek IDmaChannel yang baru dibuat. Tentukan nilai penunjuk non-NULL yang valid untuk parameter ini.

[in, optional] OuterUnknown

Penunjuk ke antarmuka IUnknown objek yang perlu menggabungkan objek. Kecuali agregasi diperlukan, atur parameter ini ke NULL.

[in] PoolType

Menentukan jenis kumpulan penyimpanan tempat objek akan dialokasikan. Ini adalah nilai enumerasi POOL_TYPE . Tentukan jenis kumpulan yang tidak bertumpuk untuk parameter ini.

[in] DeviceDescription

Arahkan ke deskripsi perangkat fisik yang pemanggilnya meminta objek DMA. Parameter ini menunjuk ke struktur jenis DEVICE_DESCRIPTION.

[in] DeviceObject

Arahkan ke objek perangkat untuk perangkat adaptor fisik. Parameter ini menunjuk ke struktur sistem jenis DEVICE_OBJECT.

Nilai kembali

PcNewDmaChannel mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, ia mengembalikan kode kesalahan yang sesuai.

Keterangan

PcNewDmaChannel sudah usang. Untuk semua driver audio baru, gunakan salah satu metode IPortWave Xxx::NewXxxDmaChannel berikut sebagai pengganti PcNewDmaChannel:

IPortWavepci::NewMasterDmaChannel

IPortWaveCyclic::NewMasterDmaChannel

IPortWaveCyclic::NewSlaveDmaChannel

Demi kompatibilitas mundur, driver sistem PortCls akan terus mendukung PcNewDmaChannel, dan driver yang ada dapat terus menggunakan fungsi ini.

Tentukan parameter PoolType untuk menjadi salah satu jenis kumpulan yang tidak disebarkan yang ditentukan dalam enumerasi POOL_TYPE. Objek saluran DMA tidak boleh berada di memori halaman karena beberapa metode dalam antarmuka IDmaChannel dapat dipanggil dari IRQL DISPATCH_LEVEL.

Parameter OutDmaChannel dan OuterUnknown mengikuti konvensi penghitungan referensi untuk objek COM.

Catatan

Microsoft mendukung lingkungan yang beragam dan inklusif. Artikel ini berisi referensi ke terminologi yang diakui panduan gaya Microsoft untuk komunikasi bebas bias sebagai pengecualian. Kata atau frasa digunakan dalam artikel ini untuk konsistensi karena saat ini muncul di perangkat lunak. Ketika perangkat lunak diperbarui untuk menghapus bahasa, artikel ini akan diperbarui agar selaras.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Kedaluwarsa. Untuk semua driver audio baru, gunakan metode IPortWaveXxx::NewXxxDmaChannel sebagai gantinya. Driver sistem PortCls mengimplementasikan fungsi PcNewDmaChannel di Microsoft Windows 98/Me dan di sistem operasi Windows 2000 dan yang lebih baru.
Target Platform	Universal
Header	portcls.h (termasuk Portcls.h)
Pustaka	Portcls.lib
IRQL	PASSIVE_LEVEL

Lihat juga