Struktur KSPRIORITY (ks.h)

  • Artikel

Struktur KSPRIORITY digunakan untuk menentukan prioritas dan digunakan dengan properti KSPROPERTY_CONNECTION_PRIORITY .

Sintaks

typedef struct {
  ULONG PriorityClass;
  ULONG PrioritySubClass;
} KSPRIORITY, *PKSPRIORITY;

Anggota

PriorityClass

Menentukan angka mulai dari 1 hingga 0xFFFFFFFF, di mana 1 adalah prioritas paling sedikit dan 0xFFFFFFFF adalah prioritas tertinggi. Nol dicadangkan untuk digunakan di masa mendatang. Saat mengatur nilai kelas, 0xFFFFFFFF digunakan untuk menunjukkan akses eksklusif ke sumber daya yang digunakan oleh pin. Nilai yang mungkin tercantum dalam tabel berikut ini.

PriorityClass Deskripsi
KSPRIORITY_LOW Menentukan prioritas terendah.
KSPRIORITY_NORMAL Menentukan prioritas normal.
KSPRIORITY_HIGH Menentukan prioritas yang ditingkatkan.
KSPRIORITY_EXCLUSIVE Menentukan prioritas tertinggi, yang menyiratkan akses eksklusif ke sumber daya.

PrioritySubClass

Menentukan angka mulai dari 1 hingga 0xFFFFFFFF, di mana 1 adalah prioritas paling sedikit dalam kelas dan 0xFFFFFFFF adalah prioritas terbanyak. Nol dicadangkan untuk digunakan di masa mendatang.

Keterangan

The KSPRIORITY. Anggota PrioritySubClass memungkinkan klien untuk menetapkan penggunaan eksklusif sumber daya yang dikonsumsi oleh pin dan juga untuk memprioritaskan penggunaan sumber daya tersebut oleh pin klien dalam kelas eksklusif tersebut. Prioritas awal pin diatur oleh permintaan koneksi yang biasanya dilakukan melalui KsCreatePin, dan biasanya KSPRIORITY_NORMAL, dengan prioritas subkelas 1. Pin menggunakan prioritas ini sebagai parameter saat mengalokasikan sumber daya bersama dari komponen apa pun yang mengelola sumber daya. Alokasi sumber daya terjadi ketika format diatur pada pin.

Jika penghapusan sumber daya oleh klien prioritas yang lebih tinggi menyebabkan pin filter gagal, klien harus diberi tahu melalui peristiwa KSEVENT_CONNECTION_PRIORITY (dengan asumsi bahwa klien telah mendaftar untuk pemberitahuan peristiwa jenis ini).

Persyaratan

Persyaratan Nilai
Header ks.h (termasuk Ks.h)

Lihat juga

KSPROPERTY_CONNECTION_PRIORITY

KsCreatePin