Partilhar via


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 de KSIDENTIFIER (consulte KSEVENT) que identifica o tipo de dados da propriedade. O Set membro de uma estrutura KSIDENTIFIER indica o conjunto de tipos de valor com suporte e a ID membro da mesma estrutura identifica o tipo dentro do conjunto.

MembersListCount

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

MembersList

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

Observações

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

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

Valor Tipo de dado
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 com término 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 sem sinal de 4 bytes.
VT_UI8 Um inteiro sem sinal de 8 bytes.

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

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

Para obter mais informações, consulte propriedades KS.

Requisitos

Requisito Valor
cabeçalho ks.h (incluir Ks.h)

Consulte também

KSEVENT

KSPROPERTY_DESCRIPTION

KSPROPERTY_ITEM

KSPROPERTY_MEMBERSLIST

VARENUM