Fungsi KsFastPropertyHandler (ks.h)

Artikel
02/29/2024

Fungsi KsFastPropertyHandler menangani permintaan properti cepat melalui IOCTL_KS_PROPERTY. Ini menanggapi semua pengidentifikasi properti yang ditentukan oleh set yang juga terkandung dalam daftar I/O cepat. Fungsi ini hanya dapat dipanggil pada PASSIVE_LEVEL.

Sintaks

KSDDKAPI BOOLEAN KsFastPropertyHandler(
  PFILE_OBJECT         FileObject,
  PKSPROPERTY          Property,
  ULONG                PropertyLength,
  PVOID                Data,
  ULONG                DataLength,
  PIO_STATUS_BLOCK     IoStatus,
  ULONG                PropertySetsCount,
  const KSPROPERTY_SET *PropertySet
);

Parameter

FileObject

Property

PropertyLength

Data

DataLength

IoStatus

PropertySetsCount

PropertySet

Nilai kembali

Fungsi KsFastPropertyHandler mengembalikan TRUE jika permintaan ditangani, atau FALSE jika permintaan tidak ditangani. Jika FALSE dikembalikan, IRP dihasilkan. Jika permintaan ditangani, fungsi mengatur elemen IoStatus-Information>, baik melalui pengaturan ke nol karena kesalahan internal, atau melalui penangan properti yang mengaturnya. Handler properti juga mengatur bidang IoStatus-Status saat properti benar-benar> ditangani.

Keterangan

Pemilik set properti dapat melakukan prafilter atau postfilter penanganan properti, serta memproses permintaan yang dibuat melalui antarmuka pengiriman I/O cepat untuk kontrol perangkat. Fungsi KsFastPropertyHandler hanya digunakan untuk memproses permintaan yang dapat dipenuhi dengan cepat. Parameter Tunggu dari fungsi I/O cepat tidak diteruskan dan diasumsikan TRUE.

Persyaratan

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

Lihat juga

KsPropertyHandler

Bagikan melalui