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

Confira também

KSPROPERTY

KSPROPERTY_ITEM

KSPROPERTY_SET