Estrutura KSMETHOD

Artigo
02/12/2024

A estrutura KSMETHOD especifica um único método de streaming de kernel dentro de um conjunto de métodos.

As estruturas KSEVENT, KSMETHOD e KSPROPERTY são aliases para a estrutura KSIDENTIFIER . Dessa forma, suas definições são idênticas.

Sintaxe

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

Membros

Set

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

Para obter mais informações sobre GUIDs do conjunto de métodos , consulte a seção Comentários abaixo.

Id

Especifica o membro do conjunto de métodos.

Flags

Especifica o tipo de solicitação. Além disso, consulte os sinalizadores de KSMETHOD_TYPE_Xxx para KSMETHOD_ITEM).

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

Valor	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 deles. O minidriver usa a estrutura KSMETHOD_ITEM para especificar o efeito do método nos parâmetros.
KSMETHOD_TYPE_SETSUPPORT	Indica consultar o minidriver para determinar se ele dá suporte ao conjunto de métodos especificado.
KSMETHOD_TYPE_TOPOLOGY	Indica que o método especificado é do tipo KSM_NODE, em que o membro NodeId é o identificador do nó de topologia. Não defina esse sinalizador por conta própria; em vez disso, OU com outros sinalizadores desta lista.

Comentários

A Microsoft fornece vários GUIDs de conjunto de métodos definidos pelo sistema. Os minidrivers especificam um desses GUIDs no membro Set . Os conjuntos de métodos de streaming de kernel normalmente começam com um prefixo KSMETHODSETID . Os conjuntos de métodos de streaming de kernel são definidos em ks.h, ksmedia.h, bdamedia.h e possivelmente em outros arquivos de cabeçalho.

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. Para obter mais informações, consulte Métodos KS.