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

Artigo
02/07/2025

O método Get recupera uma propriedade identificada por um GUID de 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 Obter repositórios no buffer em PropertyData.

Valor de retorno

Retorna NOERROR se bem-sucedido; caso contrário, retorna um código de erro.

Observações

Para recuperar uma propriedade, aloque um buffer, que Obter 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 proxy KS devem usar a versão definida em ksproxy.h. Se um aplicativo precisar incluir ksproxy.h e dsound.h, o arquivo de cabeçalho que o compilador verificar primeiro é aquele cuja definição de IKsPropertySet é usada pelo compilador.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	ksproxy.h (inclua Ksproxy.h, Dsound.h)

Consulte também

IKsPropertySet::Set

Compartilhar via