Compartilhar 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. Dessa forma, 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 de 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 solicitação de método
KSMETHOD_TYPE_BASICSUPPORT Indica consultar o minidriver para determinar se ele dá suporte ao 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 nos parâmetros especificados deve ser conhecido pelo cliente, ou seja, se os parâmetros são lidos, gravados em ambos ou nenhum dos dois. The minidriver uses the KSMETHOD_ITEM structure to specify the method's effect on the parameters.
KSMETHOD_TYPE_SETSUPPORT Indica consultar o minidriver para determinar se ele dá suporte ao 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 defina esse sinalizador por conta própria; em vez disso, OU com outros sinalizadores 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 de 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 de 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