Fungsi KsPinGetReferenceClockInterface (ks.h)

Artikel
02/29/2024

Fungsi KsPinGetReferenceClockInterface mengembalikan antarmuka gaya COM ke jam referensi yang terkait dengan Pin. Penunjuk antarmuka ini akan menjadi antarmuka IKsReferenceClock .

Sintaks

KSDDKAPI NTSTATUS KsPinGetReferenceClockInterface(
  [in]  PKSPIN             Pin,
  [out] PIKSREFERENCECLOCK *Interface
);

Parameter

[in] Pin

Penunjuk ke struktur KSPIN untuk mengembalikan antarmuka jam referensi.

[out] Interface

Pointer ke lokasi memori yang menerima alamat antarmuka IKsReferenceClock . Ini adalah antarmuka gaya COM dengan jumlah referensi terkait. Minidriver harus melepaskan antarmuka setelah selesai.

Nilai kembali

KsPinGetReferenceClockInterface mengembalikan STATUS_SUCCESS dan menyetorkan alamat antarmuka IKsReferenceClock ke Antarmuka jika pin mengimplementasikan jam atau telah menerima pemberitahuan jam master melalui properti KSPROPERTY_STREAM_MASTERCLOCK . Mengembalikan STATUS_DEVICE_NOT_READY jika pin belum menerima pemberitahuan jam master.

Keterangan

Waktu paling umum untuk memanggil KsPinGetReferenceClockInterface adalah dalam transisi status ke KSSTATE_ACQUIRE.

Lihat Jam AVStream untuk informasi selengkapnya tentang menggunakan antarmuka IKsReferenceClock yang dikembalikan rutinitas ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Microsoft Windows XP dan sistem operasi yang lebih baru dan DirectX 8.0 dan versi DirectX yang lebih baru.
Target Platform	Universal
Header	ks.h (termasuk Ks.h)
Pustaka	Ks.lib
IRQL	PASSIVE_LEVEL