Fungsi panggilan balik PFNKSFASTHANDLER (ks.h)

Artikel
03/05/2024

KStrFastHandler adalah rutinitas yang disediakan driver yang menangani permintaan properti atau metode tanpa pembuatan IRP.

Sintaks

PFNKSFASTHANDLER Pfnksfasthandler;

BOOLEAN Pfnksfasthandler(
  [in]      PFILE_OBJECT FileObject,
  [in]      PKSIDENTIFIER Request,
  [in]      ULONG RequestLength,
  [in, out] PVOID Data,
  [in]      ULONG DataLength,
  [out]     PIO_STATUS_BLOCK IoStatus
)
{...}

Parameter

[in] FileObject

Menentukan objek file tempat permintaan dibuat.

[in] Request

Menentukan parameter properti asli. Ini akan selalu berada di FILE_LONG_ALIGNMENT, tetapi tidak dapat berada di FILE_QUAD_ALIGNMENT.

[in] RequestLength

Menentukan panjang yang ditunjukkan oleh pemanggil parameter properti.

[in, out] Data

Menentukan parameter data asli yang tidak ditandatangani.

[in] DataLength

Menentukan panjang yang ditunjukkan oleh pemanggil parameter data.

[out] IoStatus

Menentukan struktur sejajar yang digunakan untuk mengembalikan status kesalahan dan informasi. Informasi ini kemudian disalin ke struktur status I/O asli setelah selesai.

Nilai kembali

KStrFastHandler mengembalikan TRUE jika panggilan ditangani. Jika panggilan tidak ditangani, panggilan mengembalikan FALSE dan IRP dibuat untuk menangani permintaan.

Keterangan

Minidriver menyediakan titik masuk untuk rutinitas ini di KSFASTPROPERTY_ITEM atau KSFASTMETHOD_ITEM.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	ks.h (termasuk Ks.h)

Bagikan melalui