Fungsi KsAllocateDefaultClock (ks.h)
Fungsi KsAllocateDefaultClock mengalokasikan dan menginisialisasi struktur jam default.
Sintaks
KSDDKAPI NTSTATUS KsAllocateDefaultClock(
[out] PKSDEFAULTCLOCK *DefaultClock
);
Parameter
[out] DefaultClock
Menentukan struktur jam default bersama yang dialokasikan pemanggil. Waktu saat ini diatur ke nol dan status diatur ke KSSTATE_STOP. Setelah berhasil menyelesaikan rutinitas ini, struktur yang ditunjukkan oleh pointer ini akan berisi referensi ke jam default. Data yang dikembalikan harus diperlakukan sebagai buram dan dicadangkan untuk penggunaan sistem.
Nilai kembali
Fungsi KsAllocateDefaultClock mengembalikan STATUS_SUCCESS jika berhasil, atau kesalahan memori jika gagal.
Keterangan
Elemen DefaultClock.ReferenceCount internal diinisialisasi menjadi satu oleh fungsi KsAllocateDefaultClock . Elemen ini bertahap dan direkrementasi karena setiap DPC pemberitahuan diantrekan dan selesai. Ketika struktur akan dikosongkan, elemen digunakan untuk menentukan apakah pemilik jam harus membebaskan struktur atau jika DPC yang tertunda harus membebaskannya secara asinkron.
Ketika jam tidak lagi diperlukan, driver harus memanggil KsFreeDefaultClock untuk melepaskan sumber daya apa pun yang dialokasikan untuk digunakan dengan jam.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Header | ks.h (termasuk Ks.h) |
| Pustaka | Ks.lib |
| IRQL | PASSIVE_LEVEL |