Método IKsControl::KsProperty (ksproxy.h)

O método KsProperty define uma propriedade ou recupera informações de propriedade, juntamente com quaisquer outras operações de suporte definidas disponíveis em um conjunto de propriedades.

Sintaxe

HRESULT KsProperty(
  [in]      PKSPROPERTY Property,
  [in]      ULONG       PropertyLength,
  [in, out] LPVOID      PropertyData,
  [in]      ULONG       DataLength,
  [in, out] ULONG       *BytesReturned
);

Parâmetros

[in] Property

Ponteiro para uma estrutura que descreve uma propriedade e o tipo de solicitação da solicitação de propriedade. Essa estrutura deve ser uma KSPROPERTY ou uma estrutura que contenha uma estrutura KSPROPERTY como seu primeiro membro. Um exemplo de uma estrutura que pode ser apontada por esse membro é a estrutura KSPROPERTY_VIDEOPROCAMP_S .

[in] PropertyLength

Tamanho, em bytes, do buffer em Propriedade.

[in, out] PropertyData

Ponteiro para um buffer que contém dados de uma operação de KSPROPERTY_TYPE_SET, KSPROPERTY_TYPE_UNSERIALIZESET ou KSPROPERTY_TYPE_UNSERIALIZERAW ou de buffer que recebe dados para todas as outras operações.

[in] DataLength

Tamanho, em bytes, do buffer em PropertyData.

[in, out] BytesReturned

Ponteiro para uma variável que recebe o tamanho, em bytes, dos dados que KsProperty armazena no buffer em PropertyData. Se nenhum dado for armazenado, o tamanho será zero.

Retornar valor

Retorna NOERROR se tiver êxito; caso contrário, retorna um código de erro.

Comentários

Para determinar o tamanho do buffer necessário para uma solicitação de propriedade específica, você pode chamar esse método com PropertyData definido como NULL e DataLength igual a zero. O método retorna HRESULT_FROM_WIN32(ERROR_MORE_DATA) e BytesReturned contém o tamanho do buffer necessário.

Requisitos

Requisito	Valor
Plataforma de Destino	DesktopMobile
Cabeçalho	ksproxy.h (inclua Ksproxy.h)

Confira também

KSPROPERTY

KSPROPERTY_VIDEOPROCAMP_S