Fungsi KsSetTargetDeviceObject (ks.h)

Artikel
08/07/2023

Fungsi KsSetTargetDeviceObject menetapkan objek perangkat target objek. Fungsi menambahkan header objek ke daftar header objek yang memiliki perangkat target.

Sintaks

KSDDKAPI VOID KsSetTargetDeviceObject(
  [in]           KSOBJECT_HEADER Header,
  [in, optional] PDEVICE_OBJECT  TargetDevice
);

Parameter

[in] Header

Menunjuk ke header yang sebelumnya dialokasikan oleh KsAllocateObjectHeader.

[in, optional] TargetDevice

Secara opsional berisi objek perangkat target yang akan digunakan saat menghitung ulang kedalaman tumpukan untuk objek perangkat yang mendasar. Jika nilainya NULL, pengaturan saat ini akan dihapus. Jika nilai adalah pengaturan apa pun selain NULL, pengaturan saat ini diganti.

Nilai kembali

Tidak ada

Keterangan

Fungsi KsSetTargetDeviceObject mengasumsikan bahwa pemanggil sebelumnya telah mengalokasikan header perangkat pada objek perangkat yang mendasar dengan fungsi KsAllocateDeviceHeader . Kehadiran header perangkat memungkinkan panggilan di masa mendatang ke fungsi KsRecalculateStackDepth, dan header perangkat digunakan ketika objek akan meneruskan RUNP melalui koneksi ke perangkat lain dan perlu melacak kedalaman tumpukan.

Jika KsSetDevicePnpAndBaseObject juga digunakan untuk menetapkan tumpukan objek PnP, objek perangkat tersebut juga akan dipertanggungjawabkan saat menghitung ulang kedalaman tumpukan.