estrutura KSPROPERTY_VALUES (ks.h)

A estrutura KSPROPERTY_VALUES descreve o tipo e os valores padrão aceitáveis de uma propriedade.

Sintaxe

typedef struct {
  KSIDENTIFIER                 PropTypeSet;
  ULONG                        MembersListCount;
  const KSPROPERTY_MEMBERSLIST *MembersList;
} KSPROPERTY_VALUES, *PKSPROPERTY_VALUES;

Membros

PropTypeSet

Especifica uma estrutura KSIDENTIFIER (consulte KSEVENT) que identifica o tipo de dados da propriedade. O membro Set de uma estrutura KSIDENTIFIER indica o conjunto de tipos de valor com suporte e o membro ID da mesma estrutura identifica o tipo dentro do conjunto.

MembersListCount

Especifica o número de entradas na matriz apontada por MembersList.

MembersList

Aponta para uma matriz de estruturas de KSPROPERTY_MEMBERSLIST . Cada entrada especifica uma lista de valores possíveis ou conjuntos de valores que a propriedade pode assumir.

Comentários

PropTypeSet.Set quase sempre é igual a KSPROPTYPESETID_General. Os tipos de valor individuais em KSPROPTYPESETID_General correspondem aos tipos de enumeração VARENUM .

Os valores possíveis para PropTypeSet.Id na mídia de streaming (áudio/câmera) incluem:

Valor Tipo de dados
VT_BLOB Bytes prefixados por comprimento.
VT_BOOL Um valor booliano. True é -1 e false é 0.
VT_CLSID Uma ID de classe.
VT_I4 Um inteiro de 4 bytes.
VT_ILLEGAL Um valor ilegal.
VT_LPWSTR Uma cadeia de caracteres terminada em nulo largo.
VT_R8 Um real de 8 bytes.
VT_UI1 Um caractere sem sinal.
VT_UI2 Um curto sem sinal.
VT_UI4 Um inteiro de 4 bytes sem sinal.
VT_UI8 Um inteiro de 8 bytes sem sinal.

Para obter mais informações, consulte a enumeração VARENUM .

Um driver pode especificar um ponteiro para uma estrutura KSPROPERTY_VALUES no KSPROPERTY_ITEM relevante para uma propriedade.

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

Requisitos

Requisito Valor
Cabeçalho ks.h (inclua Ks.h)

Confira também

KSEVENT

KSPROPERTY_DESCRIPTION

KSPROPERTY_ITEM

KSPROPERTY_MEMBERSLIST

VARENUM