Bagikan melalui


KSMETHOD structure

The KSMETHOD structure specifies a single kernel streaming method within a method set.

The KSEVENT, KSMETHOD, and KSPROPERTY structures are aliases for the KSIDENTIFIER structure. Dengan demikian, definisi mereka identik.

Syntax

struct KSMETHOD {
  GUID Set;
  ULONG Id;
  ULONG Flags;
};

Members

Set

Menentukan GUID yang mengidentifikasi set metode streaming kernel.

For more information about method set GUIDs, see the Remarks section below.

Id

Menentukan anggota set metode.

Flags

Menentukan jenis permintaan. Also, see the KSMETHOD_TYPE_Xxx flags for KSMETHOD_ITEM).

Permintaan dapat berisi kombinasi nilai yang tercantum dalam tabel berikut.

Value Jenis permintaan metode
KSMETHOD_TYPE_BASICSUPPORT Menunjukkan untuk mengkueri minidriver untuk menentukan apakah mendukung metode yang ditentukan dari set metode.
KSMETHOD_TYPE_SEND Menunjukkan bahwa minidriver harus menjalankan metode yang ditentukan. Efek metode pada parameter yang diberikan harus diketahui oleh klien, yaitu, apakah parameter dibaca dari, ditulis ke, keduanya, atau tidak. The minidriver uses the KSMETHOD_ITEM structure to specify the method's effect on the parameters.
KSMETHOD_TYPE_SETSUPPORT Menunjukkan untuk mengkueri minidriver untuk menentukan apakah mendukung kumpulan metode yang ditentukan.
KSMETHOD_TYPE_TOPOLOGY Indicates that the specified method is of type KSM_NODE, where the NodeId member is the identifier of the topology node. Jangan atur bendera ini sendiri; sebagai gantinya, ATAU dengan bendera lain dari daftar ini.

Remarks

Microsoft menyediakan beberapa GUID set metode yang ditentukan sistem. Minidrivers specify one of these GUIDs in the Set member. Kernel streaming method sets typically begin with a KSMETHODSETID prefix. Kernel streaming method sets are defined in ks.h, ksmedia.h, bdamedia.h, and possibly other header files.

Untuk informasi selengkapnya tentang peristiwa streaming kernel, lihat Properti KS, Peristiwa, dan Metode.

Klien dapat menggunakan permintaan IOCTL_KS_METHOD bersama dengan struktur KSMETHOD untuk menjalankan metode pada objek streaming kernel yang ditangani minidriver. For more information, see KS Methods.

Requirements

Header: ks.h (include Ks.h)

See also

KSEVENT

KSPROPERTY

KSIDENTIFIER

KSMETHOD_ITEM

KSE_NODE