Método IKsPropertySet::Get (dsound.h)
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 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. 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, 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 | dsound.h (inclua Ksproxy.h, Dsound.h) |