Fungsi KsReferenceBusObject (ks.h)

Mereferensikan objek perangkat Fisik bus.

Sintaks

KSDDKAPI NTSTATUS KsReferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

Parameter

[in] Header

Menunjuk ke header yang sebelumnya dialokasikan oleh KsAllocateDeviceHeader yang juga berisi objek tumpukan perangkat PnP.

Nilai kembali

Mengembalikan STATUS_SUCCESS jika referensi berhasil, atau kesalahan seperti STATUS_INSUFFICIENT_RESOURCES.

Keterangan

Fungsi ini digunakan oleh filter yang menggunakan header perangkat untuk melacak tumpukan objek PnP mereka. Ini biasanya dipanggil pada Buka filter yang berhasil ketika bus untuk perangkat ini memerlukan referensi seperti itu (seperti perangkat perangkat lunak), dan dicocokkan dengan panggilan ke KsDereferenceBusObject pada penutupan instans filter tersebut. Pemanggil sebelumnya juga harus disebut KsSetDevicePnpAndBaseObject untuk mengatur objek tumpukan perangkat PnP. Ini akan dilakukan dalam fungsi PnP AddDevice. Jika objek belum dirujuk sebelumnya, ruang antarmuka dialokasikan dan fungsi menggunakan objek perangkat PnP untuk memperoleh antarmuka referensi bus. Kemudian memanggil metode ReferenceDeviceObject pada antarmuka tersebut. Antarmuka itu sendiri dirilis dan dibebaskan ketika header perangkat dibebaskan.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	ks.h (termasuk Ks.h)
Pustaka	Ks.lib