Fungsi PcRegisterSubdevice (portcls.h)

Fungsi PcRegisterSubdevice mendaftarkan subdevice untuk membuatnya tersedia untuk digunakan oleh klien.

Sintaks

PORTCLASSAPI NTSTATUS PcRegisterSubdevice(
  [in] PDEVICE_OBJECT DeviceObject,
  [in] PWSTR          Name,
  [in] PUNKNOWN       Unknown
);

Parameter

[in] DeviceObject

Penunjuk ke objek perangkat driver adaptor. Ini adalah struktur sistem jenis DEVICE_OBJECT.

[in] Name

Penunjuk ke string Unicode yang dihentikan null yang menentukan nama subdevice. Buffer string yang dituju parameter Nama harus tetap valid selama masa pakai objek perangkat. String berisi nama pendek yang membedakan subdevice dari subdevice lainnya yang terdaftar pada perangkat yang sama. Setiap subdevice perangkat harus memiliki nama yang unik.

[in] Unknown

Penunjuk ke antarmuka IPort dari objek driver port yang terikat ke subdevice.

Nilai kembali

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

Keterangan

Fungsi ini mendaftarkan instans antarmuka perangkat untuk objek filter yang mewakili subdevice pada adaptor audio. Manajer I/O menambahkan string yang ditentukan oleh parameter Nama ke string referensi yang digunakannya untuk mengidentifikasi instans. String referensi yang dimodifikasi berguna untuk membedakan di antara subdevice dalam adaptor audio. Untuk informasi selengkapnya tentang string referensi, lihat IoRegisterDeviceInterface.

Untuk informasi selengkapnya tentang peran fungsi PcRegisterSubdevice dalam mendaftarkan subdevice, lihat Pembuatan Subdevice.

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

Persyaratan

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

DEVICE_OBJECT

IPort

IUnregisterSubdevice::UnregisterSubdevice

IoRegisterDeviceInterface