Fungsi FltDeviceIoControlFile (fltkernel.h)

Artikel
02/26/2024

FltDeviceIoControlFile mengirim kode kontrol langsung ke driver perangkat tertentu, menyebabkan driver yang sesuai untuk melakukan tindakan yang ditentukan.

Sintaks

NTSTATUS FLTAPI FltDeviceIoControlFile(
  [in]            PFLT_INSTANCE Instance,
  [in]            PFILE_OBJECT  FileObject,
  [in]            ULONG         IoControlCode,
  [in, optional]  PVOID         InputBuffer,
  [in]            ULONG         InputBufferLength,
  [out]           PVOID         OutputBuffer,
  [in]            ULONG         OutputBufferLength,
  [out, optional] PULONG        LengthReturned
);

Parameter

[in] Instance

Penunjuk instans buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.

[in] FileObject

Penunjuk objek file untuk file atau perangkat yang menjadi target permintaan ini. Parameter ini diperlukan dan tidak boleh NULL.

[in] IoControlCode

IOCTL_XXX yang menunjukkan operasi I/O perangkat mana yang akan dilakukan. Nilai parameter ini menentukan format dan panjang inputBuffer dan OutputBuffer yang diperlukan, dan menentukan pasangan parameter berikut mana (InputBuffer dan InputBufferLength, atau OutputBuffer dan OutputBufferLength) yang diperlukan.

[in, optional] InputBuffer

Penunjuk ke buffer input yang dialokasikan pemanggil yang berisi informasi khusus perangkat untuk diberikan kepada driver target. Jika parameter IoControlCode menentukan operasi yang tidak memerlukan data input, parameter ini bersifat opsional dan dapat berupa NULL.

[in] InputBufferLength

Ukuran, dalam byte, dari buffer di InputBuffer. Nilai ini diabaikan jika InputBuffer ADALAH NULL.

[out] OutputBuffer

Pointer ke buffer output yang dialokasikan penelepon tempat informasi dikembalikan dari driver target. Jika parameter IoControlCode menentukan operasi yang tidak memerlukan data output, parameter ini bersifat opsional dan dapat berupa NULL.

[in] OutputBufferLength

Ukuran, dalam byte, dari buffer di OutputBuffer. Nilai ini diabaikan jika OutputBufferADALAH NULL.

[out, optional] LengthReturned

Penunjuk ke variabel yang dialokasikan pemanggil yang menerima ukuran, dalam byte, dari informasi yang dikembalikan dalam buffer di OutputBuffer. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

FltDeviceIoControlFile mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai.

Keterangan

Untuk informasi selengkapnya tentang kode IOCTL_XXXX yang ditentukan sistem, lihat bagian Keterangan dari entri referensi untuk DeviceIoControl dalam dokumentasi Microsoft Windows SDK.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	fltkernel.h (termasuk Fltkernel.h)
Pustaka	FltMgr.lib
IRQL	PASSIVE_LEVEL

Lihat juga

FltFsControlFile

Bagikan melalui