Fungsi KsRegisterCountedWorker (ks.h)

Menangani klien yang mendaftar untuk penggunaan utas.

Sintaks

KSDDKAPI NTSTATUS KsRegisterCountedWorker(
  [in]  WORK_QUEUE_TYPE  WorkQueueType,
  [in]  PWORK_QUEUE_ITEM CountedWorkItem,
  [out] PKSWORKER        *Worker
);

Parameter

[in] WorkQueueType

Berisi prioritas alur kerja. Ini biasanya salah satu dari yang berikut ini: CriticalWorkQueue, DelayedWorkQueue, atau HyperCriticalWorkQueue.

[in] CountedWorkItem

Berisi penunjuk ke item antrean kerja yang akan diantrekan sesuai kebutuhan berdasarkan nilai hitungan saat ini.

[out] Worker

Berisi konteks buram yang harus digunakan saat menjadwalkan item kerja. Juga berisi jenis antrean, dan digunakan untuk menyinkronkan penyelesaian item kerja.

Nilai kembali

Mengembalikan STATUS_SUCCESS jika pekerja diinisialisasi.

Keterangan

Ini harus dicocokkan dengan KsUnregisterWorker yang sesuai saat penggunaan utas selesai. Fungsi ini menyerupan KsRegisterWorker, dengan penambahan meneruskan item kerja yang akan selalu diantrekan. Ini akan digunakan dengan KsIncrementCountedWorker dan KsDecrementCountedWorker untuk meminimalkan jumlah item kerja yang diantrekan, dan mengurangi kode pengecualian timbal balik yang diperlukan dalam item kerja yang diperlukan untuk menserialisasikan akses terhadap beberapa utas item kerja. Antrean pekerja masih dapat digunakan untuk mengantre item kerja lainnya. Ini mungkin hanya dipanggil pada PASSIVE_LEVEL.

Persyaratan

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