Estrutura KSMETHOD
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.
Requisitos
Cabeçalho: ks.h (inclua Ks.h)