Condividi tramite


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. Di conseguenza, le relative definizioni sono identiche.

Syntax

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

Members

Set

Specifica un GUID che identifica un set di metodi di streaming del kernel.

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

Id

Specifica il membro del set di metodi.

Flags

Specifica il tipo di richiesta. Also, see the KSMETHOD_TYPE_Xxx flags for KSMETHOD_ITEM).

Una richiesta può contenere una combinazione dei valori elencati nella tabella seguente.

Value Tipo di richiesta di metodo
KSMETHOD_TYPE_BASICSUPPORT Indica di eseguire una query sul minidriver per determinare se supporta il metodo specificato del set di metodi.
KSMETHOD_TYPE_SEND Indica che il minidriver deve eseguire il metodo specificato. L'effetto del metodo sui parametri specificati deve essere noto al client, ovvero se i parametri vengono letti, scritti in, entrambi o nessuno dei due. The minidriver uses the KSMETHOD_ITEM structure to specify the method's effect on the parameters.
KSMETHOD_TYPE_SETSUPPORT Indica di eseguire una query sul minidriver per determinare se supporta il set di metodi specificato.
KSMETHOD_TYPE_TOPOLOGY Indicates that the specified method is of type KSM_NODE, where the NodeId member is the identifier of the topology node. Non impostare questo flag autonomamente; In alternativa, OR con altri flag di questo elenco.

Remarks

Microsoft fornisce diversi GUID del set di metodi definiti dal sistema. 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.

Per altre informazioni sugli eventi di streaming del kernel, vedere proprietà, eventi e metodi KS.

Un client può usare la richiesta di IOCTL_KS_METHOD insieme alla struttura KSMETHOD per eseguire metodi su un oggetto di streaming del kernel gestito dal minidriver. For more information, see KS Methods.

Requirements

Header: ks.h (include Ks.h)

See also

KSEVENT

KSPROPERTY

KSIDENTIFIER

KSMETHOD_ITEM

KSE_NODE