Método IKsControl::KsProperty (ksproxy.h)
O método KsProperty define uma propriedade ou recupera informações de propriedade, juntamente com quaisquer outras operações de suporte definidas disponíveis em um conjunto de propriedades.
Sintaxe
HRESULT KsProperty(
[in] PKSPROPERTY Property,
[in] ULONG PropertyLength,
[in, out] LPVOID PropertyData,
[in] ULONG DataLength,
[in, out] ULONG *BytesReturned
);
Parâmetros
[in] Property
Ponteiro para uma estrutura que descreve uma propriedade e o tipo de solicitação da solicitação de propriedade. Essa estrutura deve ser uma KSPROPERTY ou uma estrutura que contenha uma estrutura KSPROPERTY como seu primeiro membro. Um exemplo de uma estrutura que pode ser apontada por esse membro é a estrutura KSPROPERTY_VIDEOPROCAMP_S .
[in] PropertyLength
Tamanho, em bytes, do buffer em Propriedade.
[in, out] PropertyData
Ponteiro para um buffer que contém dados de uma operação de KSPROPERTY_TYPE_SET, KSPROPERTY_TYPE_UNSERIALIZESET ou KSPROPERTY_TYPE_UNSERIALIZERAW ou de buffer que recebe dados para todas as outras operações.
[in] DataLength
Tamanho, em bytes, do buffer em PropertyData.
[in, out] BytesReturned
Ponteiro para uma variável que recebe o tamanho, em bytes, dos dados que KsProperty armazena no buffer em PropertyData. Se nenhum dado for armazenado, o tamanho será zero.
Retornar valor
Retorna NOERROR se tiver êxito; caso contrário, retorna um código de erro.
Comentários
Para determinar o tamanho do buffer necessário para uma solicitação de propriedade específica, você pode chamar esse método com PropertyData definido como NULL e DataLength igual a zero. O método retorna HRESULT_FROM_WIN32(ERROR_MORE_DATA) e BytesReturned contém o tamanho do buffer necessário.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | DesktopMobile |
| Cabeçalho | ksproxy.h (inclua Ksproxy.h) |