Método IKsControl::KsProperty (ks.h)
O método IKsControl::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
NTSTATUS KsProperty(
[in] PKSPROPERTY Property,
[in] ULONG PropertyLength,
[in, out] PVOID PropertyData,
[in] ULONG DataLength,
[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
Especifica o tamanho, em bytes, do buffer em Propriedade.
[in, out] PropertyData
Ponteiro para um buffer que contém dados para uma operação de KSPROPERTY_TYPE_SET, KSPROPERTY_TYPE_UNSERIALIZESET ou KSPROPERTY_TYPE_UNSERIALIZERAW ou espaço em buffer que recebe dados para todas as outras operações.
[in] DataLength
Especifica o tamanho, em bytes, do buffer em PropertyData.
[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
O método IKsControl::KsProperty retorna o mesmo valor que seria retornado se a propriedade tivesse sido enviada pelo IOCTL.
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 | ks.h (inclua Ks.h) |