Fungsi PcNewPort (portcls.h)

Artikel
02/29/2024

Fungsi PcNewPort membuat objek port-driver baru yang disediakan sistem, yang antarmukanya (berasal dari kelas dasar IPort) ditentukan oleh ID kelas.

Sintaks

PORTCLASSAPI NTSTATUS PcNewPort(
  [out] PPORT    *OutPort,
  [in]  REFCLSID ClassID
);

Parameter

[out] OutPort

Penunjuk output untuk objek port-driver yang dibuat oleh fungsi ini. Parameter ini menunjuk ke variabel pointer yang dialokasikan penelepon tempat fungsi menghasilkan pointer ke objek IPort yang baru dibuat. Objek ini memiliki antarmuka port yang ditentukan oleh parameter ClassId . Tentukan nilai penunjuk non-NULL yang valid untuk parameter ini.

[in] ClassID

Menentukan jenis antarmuka port yang sedang diminta. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Nilai kembali

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

Keterangan

Parameter ClassId dapat diatur ke salah satu GUID dalam tabel berikut.

GUID Kelas	Nama Antarmuka Port
CLSID_PortDMus	IPortDMus
CLSID_PortMidi	IPortMidi
CLSID_PortTopology	IPortTopology
CLSID_PortWaveCyclic	IPortWaveCyclic
CLSID_PortWavePci	IPortWavePci
CLSID_PortWaveRT	IPortWaveRT

CLSID_PortDMus didefinisikan dalam file header dmusicks.h. Empat GUID lainnya dalam tabel sebelumnya didefinisikan dalam portcls.h.

Di Microsoft Windows XP dan yang lebih baru, driver port MIDI dan DirectMusic berbagi implementasi perangkat lunak internal yang sama. Ini berarti bahwa GUID CLSID_PortMidi setara dengan CLSID_PortDMus.

Untuk informasi selengkapnya tentang membuat driver port dan miniport untuk subdevice, lihat Pembuatan Subdevice.

Parameter OutPort mengikuti konvensi penghitungan referensi untuk objek COM.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Driver sistem PortCls mengimplementasikan fungsi PcNewPort 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