struktur KSMETHOD_ITEM (ks.h)

  • Artikel

Struktur KSMETHOD_ITEM menjelaskan satu metode dalam satu set metode.

Sintaks

typedef struct {
  ULONG        MethodId;
  union {
    PFNKSHANDLER MethodHandler;
    BOOLEAN      MethodSupported;
  };
  ULONG        MinMethod;
  ULONG        MinData;
  PFNKSHANDLER SupportHandler;
  ULONG        Flags;
} KSMETHOD_ITEM, *PKSMETHOD_ITEM;

Anggota

MethodId

Menentukan pengidentifikasi metode ini dalam set metodenya.

MethodHandler

Penunjuk ke rutinitas panggilan balik KStrMethodHandler yang disediakan minidriver.

MethodSupported

Menentukan apakah metode ini didukung atau tidak.

MinMethod

Menentukan ukuran minimum buffer yang diperlukan untuk menentukan metode sepenuhnya. Ukuran ini setidaknya ukuranof (KSMETHOD) byte.

MinData

Menentukan buffer ukuran minimum yang diperlukan untuk menentukan buffer data metode. Buffer ini digunakan untuk membaca dan/atau menulis informasi yang terkait dengan metode .

SupportHandler

Penunjuk ke rutinitas panggilan balik KStrSupportHandler yang disediakan minidriver.

Flags

Menentukan jenis permintaan permintaan metode ini.

Nilai Jenis permintaan metode
KSMETHOD_TYPE_NONE Menunjukkan bahwa buffer Data handler tidak diharapkan untuk digunakan. Untuk metode buffer, meskipun ruang dialokasikan, tidak ada data yang disalin ke atau dari buffer sistem. Saat dalam mode sumber (KSMETHOD_TYPE_SOURCE), tidak ada MDL yang dibuat.
KSMETHOD_TYPE_READ Menunjukkan bahwa parameter diharapkan dibaca dari buffer Data handler. Ketika di-buffer, data disalin ke buffer sistem. Saat dalam mode sumber, data diselimuti dan dikunci untuk IoReadAccess.
KSMETHOD_TYPE_WRITE Menunjukkan bahwa parameter diharapkan ditulis ke buffer Data handler. Ketika di-buffer, data disalin dari buffer sistem. Saat dalam mode sumber, data diselimuti dan dikunci untuk IoWriteAccess.
KSMETHOD_TYPE_MODIFY Menunjukkan bahwa parameter diharapkan dibaca dan ditulis ke buffer Data handler. Data yang diteruskan ditimpa oleh data yang dikembalikan. Ini mungkin menyiratkan bahwa struktur yang diteruskan hanya dapat diperbarui. Ketika di-buffer, data disalin ke buffer sistem, dan disalin kembali ketika IRP selesai. Saat dalam mode sumber, data diselimuti dan dikunci untuk IoModifyAccess.
KSMETHOD_TYPE_SOURCE Menunjukkan bahwa metode ini akan diproses dalam mode sumber. MDL dialokasikan dan data diselimuti dan dikunci. Untuk menunjukkan metode buffer, ATAU bendera ini dengan bendera lain dari daftar ini.

Keterangan

Minidriver menggunakan struktur KSMETHOD_ITEM untuk menentukan metode dalam set metode. Minidriver mengimplementasikan metode dan menggunakan anggota MethodHandler untuk menunjuk ke metode ini. Klien kemudian dapat menggunakan permintaan IOCTL_KS_METHOD bersama dengan struktur KSMETHOD untuk menjalankan metode pada objek streaming kernel yang ditangani minidriver. Untuk informasi selengkapnya, lihat Metode KS.

Persyaratan

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

Lihat juga

KSFASTMETHOD_ITEM

KSMETHOD

KStrSupportHandler