Método IKsPropertySet::Get (ksproxy.h)

  • Artigo

O método Get recupera uma propriedade identificada por um GUID do conjunto de propriedades e um identificador de propriedade.

Sintaxe

HRESULT Get(
  [in]  REFGUID PropSet,
  [in]  ULONG   Id,
  [in]  LPVOID  InstanceData,
  [in]  ULONG   InstanceLength,
  [out] LPVOID  PropertyData,
  [in]  ULONG   DataLength,
  [out] ULONG   *BytesReturned
);

Parâmetros

[in] PropSet

GUID que identifica o conjunto de propriedades.

[in] Id

Identificador da propriedade dentro do conjunto de propriedades.

[in] InstanceData

Ponteiro para dados de instância para a propriedade .

[in] InstanceLength

Tamanho, em bytes, do buffer em InstanceData.

[out] PropertyData

Ponteiro para um buffer que recebe o valor da propriedade .

[in] DataLength

Tamanho, em bytes, do buffer em PropertyData.

[out] BytesReturned

Ponteiro para uma variável que recebe o tamanho, em bytes, dos dados que Get armazena no buffer em PropertyData.

Retornar valor

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

Comentários

Para recuperar uma propriedade, aloque um buffer, que Get preenche com a propriedade . Para determinar o tamanho do buffer necessário, especifique NULL para PropertyData e zero para DataLength. O método Get retorna o tamanho do buffer necessário em BytesReturned.

Aviso

Os arquivos de cabeçalho ksproxy.h e dsound.h definem versões semelhantes, mas incompatíveis da interface IKsPropertySet . Os aplicativos que exigem o módulo de proxy KS devem usar a versão definida em ksproxy.h. Se um aplicativo precisar incluir ksproxy.h e dsound.h, qualquer arquivo de cabeçalho que o compilador examinar primeiro será aquele cuja definição de IKsPropertySet será usada pelo compilador.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho ksproxy.h (incluem Ksproxy.h, Dsound.h)

Confira também

IKsPropertySet::Set