Struktur KSPRIORITY (ks.h)
Struktur KSPRIORITY digunakan untuk menentukan prioritas dan digunakan dengan properti KSPROPERTY_CONNECTION_PRIORITY.
Sintaksis
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.
| 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 yang paling prioritas. Nol dicadangkan untuk digunakan di masa mendatang.
Komentar
The KSPRIORITY. Anggota PrioritySubClass memungkinkan klien untuk mengatur penggunaan eksklusif sumber daya yang digunakan 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 mana 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
| Syarat | Nilai |
|---|---|
| Header | ks.h (termasuk Ks.h) |