Método IKsPropertySet::Get (ksproxy.h)
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) |