Partilhar via


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. Como tal, as suas definições são idênticas.

Syntax

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

Members

Set

Especifica um GUID que identifica um conjunto de métodos de streaming do kernel.

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

Id

Especifica o membro do conjunto de métodos.

Flags

Especifica o tipo de solicitação. Also, see the KSMETHOD_TYPE_Xxx flags for KSMETHOD_ITEM).

Uma solicitação pode conter uma combinação dos valores listados na tabela a seguir.

Value Tipo de pedido de método
KSMETHOD_TYPE_BASICSUPPORT Indica para consultar o minidriver para determinar se ele suporta o método especificado do conjunto de métodos.
KSMETHOD_TYPE_SEND Indica que o minidriver deve executar o método especificado. O efeito do método sobre os parâmetros dados deve ser conhecido pelo cliente, isto é, se os parâmetros são lidos, gravados em, ambos, ou nenhum. The minidriver uses the KSMETHOD_ITEM structure to specify the method's effect on the parameters.
KSMETHOD_TYPE_SETSUPPORT Indica para consultar o minidriver para determinar se ele suporta o conjunto de métodos especificado.
KSMETHOD_TYPE_TOPOLOGY Indicates that the specified method is of type KSM_NODE, where the NodeId member is the identifier of the topology node. Não coloque esta bandeira por conta própria; em vez disso, OU com outras bandeiras desta lista.

Remarks

A Microsoft fornece vários GUIDs de conjunto de métodos definidos pelo 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.

Para obter mais informações sobre eventos de streaming do kernel, consulte Propriedades, eventos e métodos do KS.

Um cliente pode usar a solicitação IOCTL_KS_METHOD junto com a estrutura KSMETHOD para executar métodos em um objeto de streaming do kernel que o minidriver manipula. For more information, see KS Methods.

Requirements

Header: ks.h (include Ks.h)

See also

KSEVENT

KSPROPERTY

KSIDENTIFIER

KSMETHOD_ITEM

KSE_NODE