Fungsi PcRegisterPhysicalConnection (portcls.h)

Artikel
08/07/2023

Fungsi PcRegisterPhysicalConnection mendaftarkan koneksi fisik antara dua filter adaptor audio yang dibuat oleh driver adaptor yang sama.

Sintaks

PORTCLASSAPI NTSTATUS PcRegisterPhysicalConnection(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PUNKNOWN       FromUnknown,
  [in] ULONG          FromPin,
  [in] PUNKNOWN       ToUnknown,
  [in] ULONG          ToPin
);

Parameter

[in] DeviceObject

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

[in] FromUnknown

Penunjuk ke antarmuka IPort dari objek driver port. Objek driver port yang terkait dengan FromUnknown terikat dengan subdevice yang memasok pin sumber data (output) koneksi.

[in] FromPin

Menentukan ID pin. Parameter ini mengidentifikasi pin sumber (output) pada filter yang terkait dengan antarmuka FromUnknown .

[in] ToUnknown

Penunjuk ke antarmuka IPort dari objek driver port. Objek driver port yang terkait dengan ToUnknown terikat ke subdevice yang memasok pin sink data (input) koneksi.

[in] ToPin

Menentukan ID pin. Parameter ini mengidentifikasi pin sink (input) pada filter yang terkait dengan antarmuka ToUnknown .

Nilai kembali

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

Keterangan

Driver adaptor memanggil PcRegisterPhysicalConnection untuk mendaftarkan koneksi fisik dengan driver sistem PortCls. PortCls menyimpan informasi ini sehingga driver port kemudian dapat menggunakan informasi untuk menanggapi permintaan properti KSPROPERTY_PIN_PHYSICALCONNECTION .

Parameter yang disediakan pemanggil ke fungsi PcRegisterPhysicalConnection menjelaskan koneksi fisik antara dua subdevice (direpresentasikan sebagai filter individual) pada kartu adaptor yang sama.

Tidak seperti koneksi logis antara dua pin, yang dapat dikonfigurasi di bawah kontrol perangkat lunak, koneksi fisik diperkeras. Misalnya, kartu adaptor khas mungkin memiliki koneksi fisik yang membawa sinyal analog dari pin output filter output gelombangnya ke pin input filter topologinya.

Untuk contoh rutinitas device-startup driver adapter (lihat Urutan Startup) yang menggunakan panggilan PcRegisterPhysicalConnection untuk mendaftarkan koneksi fisik adaptor, lihat kode sumber untuk driver audio sampel SB16 di Microsoft Windows Driver Kit (WDK).

Driver adaptor dapat memanggil metode IUnregisterPhysicalConnection::UnregisterPhysicalConnection untuk menghapus pendaftaran koneksi fisik yang didaftarkan oleh panggilan sebelumnya ke PcRegisterPhysicalConnection. Untuk informasi selengkapnya, lihat Subdevice Audio Dinamis.

Persyaratan

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