Compartilhar via

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

  • Artigo

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 rguidPropSet,
  [in]  ULONG   ulId,
  [in]  LPVOID  pInstanceData,
  [in]  ULONG   ulInstanceLength,
  [out] LPVOID  pPropertyData,
  [in]  ULONG   ulDataLength,
  [out] PULONG  pulBytesReturned
);

Parâmetros

[in] rguidPropSet

GUID que identifica o conjunto de propriedades.

[in] ulId

Identificador da propriedade dentro do conjunto de propriedades.

[in] pInstanceData

Ponteiro para dados de instância para a propriedade .

[in] ulInstanceLength

Tamanho, em bytes, do buffer em InstanceData.

[out] pPropertyData

Ponteiro para um buffer que recebe o valor da propriedade .

[in] ulDataLength

Tamanho, em bytes, do buffer em PropertyData.

[out] pulBytesReturned

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

Retornar valor

Retorna 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. A versão DirectSound do IKsPropertySet é descrita nas páginas de referência do DirectSound na documentação do SDK do Microsoft Windows. 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 dsound.h (inclua Ksproxy.h, Dsound.h)

Confira também

IKsPropertySet::Set