estrutura KSPROPERTY_DESCRIPTION (ks.h)

Artigo
08/07/2023

A estrutura KSPROPERTY_DESCRIPTION especifica o tamanho e o tipo de valores contidos em uma propriedade específica.

Sintaxe

typedef struct {
  ULONG        AccessFlags;
  ULONG        DescriptionSize;
  KSIDENTIFIER PropTypeSet;
  ULONG        MembersListCount;
  ULONG        Reserved;
} KSPROPERTY_DESCRIPTION, *PKSPROPERTY_DESCRIPTION;

Membros

AccessFlags

Especifica o acesso permitido a essa propriedade. Uma solicitação de suporte básico define esse membro como o OR bit a bit dos sinalizadores para todos os tipos de acesso aos quais o manipulador dá suporte para essa propriedade. Para obter uma lista de valores de sinalizador possíveis, consulte KSPROPERTY.

DescriptionSize

Especifica o tamanho total em bytes da estrutura KSPROPERTY_DESCRIPTION e quaisquer entradas de valores que a seguem. Se a solicitação de propriedade de suporte básico não retornar entradas de valores, esse membro terá o tamanho de KSPROPERTY_DESCRIPTION.

PropTypeSet

Uma estrutura do tipo KSIDENTIFIER. Se compatível com a propriedade específica, especifica o tipo de valores contidos nessa propriedade. Esse grupo é especificado exclusivamente por um GUID, de modo que novos tipos de valores possam ser criados sem sobreposição com extensões para esse conjunto. Os tipos de valor indicam o tipo do valor (como VT_BOOL, VT_UI4 no conjunto padrão). Isso é GUID_NULL, com um identificador igual a zero, se as informações de valores não tiverem suporte nessa propriedade.

MembersListCount

Especifica o número de estruturas de KSPROPERTY_MEMBERSHEADER para seguir esse cabeçalho.

Reserved

Reservado para uso futuro. Defina como zero.

Comentários

Um driver retorna a estrutura KSPROPERTY_DESCRIPTION em resposta a uma solicitação de propriedade de suporte básica de um cliente.

O conjunto de tipos de valores de propriedade é especificado por uma estrutura KSIDENTIFIER . O conjunto básico com suporte é KSPROPSETID_General. Os identificadores dentro desse conjunto são os tipos VARENUM padrão usados para OLE.

As informações de valores que podem seguir a estrutura KSPROPERTY_DESCRIPTION são descritas por uma lista de estruturas de KSPROPERTY_MEMBERSLIST , cada uma das quais contém informações de intervalo de dados.

Para obter mais informações, consulte Propriedades do KS.