Conjuntos de propriedades do codificador
Esta seção descreve os conjuntos de propriedades específicos da API de codificador e codec que estão disponíveis para minidrivers de codificador que usam serviços de streaming de kernel WDM no Microsoft Windows 98/Me, Windows 2000 e Windows XP e posterior.
A página de referência de cada propriedade contém uma tabela com os títulos de coluna mostrados abaixo.
| Obter | Definir | Destino | Tipo de descritor de propriedade | Tipo de valor da propriedade |
|---|---|---|---|---|
Esses títulos têm os seguintes significados:
Get
O objeto KS de destino dá suporte à solicitação de propriedade KSPROPERTY_TYPE_GET?
Configurar
O objeto KS de destino dá suporte à solicitação de propriedade KSPROPERTY_TYPE_SET?
Target (destino)
Este é o objeto KS para o qual a solicitação de propriedade é enviada. O destino de uma propriedade do codificador de vídeo é um filtro ou um pino. (A solicitação de propriedade especifica o objeto de destino por seu identificador de kernel.)
Tipo de descritor de propriedade
O descritor de propriedade especifica a propriedade e a operação a serem executadas nessa propriedade. O descritor sempre começa com uma estrutura KSPROPERTY .
Tipo de valor da propriedade
Uma propriedade tem um valor e o tipo desse valor depende da propriedade . Por exemplo, uma propriedade que pode estar em um dos dois únicos estados – ativado ou desativado – normalmente tem um valor BOOL. Uma propriedade que pode assumir valores inteiros de 0x0 para 0xFFFFFFFF pode ter um valor ULONG. Propriedades mais complexas podem ter valores que são matrizes ou estruturas.
O descritor de propriedade e o valor da propriedade acima são as versões específicas da propriedade dos buffers de especificação de instância e de dados de operação discutidos em Propriedades, Eventos e Métodos do KS.
Uma solicitação de propriedade usa um dos seguintes sinalizadores para especificar a operação que deve ser executada na propriedade :
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
Todos os objetos de filtro e fixação dão suporte à operação de suporte básico em suas propriedades. Se elas dão suporte às operações get e Set dependem da propriedade . Uma propriedade que representa uma funcionalidade inerente do objeto de filtro ou pino provavelmente exigirá apenas uma operação get . Uma propriedade que representa uma configuração configurável pode exigir apenas uma operação Set , embora uma operação get também possa ser útil para ler a configuração atual. Para obter mais informações sobre como usar as operações get, set e basic-support com propriedades do codificador de vídeo, consulte Propriedades do KS.
Uma tabela na descrição de cada propriedade indica se os minidrivers do codificador de vídeo são necessários para dar suporte à leitura ou gravação da propriedade. Os minidrivers do codificador de vídeo devem retornar STATUS_NOT_SUPPORTED em resposta para obter ou definir solicitações para propriedades que não são compatíveis com o minidriver.
Os conjuntos de propriedades a seguir contêm uma única propriedade que deve ser implementada por minidrivers do codificador de vídeo. Ou seja, efetivamente, cada propriedade obtém seu próprio conjunto, portanto, especifique 0 no membro PropertyId do membro KSPROPERTY_ITEM na estrutura KSPROPERTY_SET conforme necessário.
Os seguintes conjuntos de propriedades pertencem à API codec:
Os seguintes conjuntos de propriedades pertencem à API do codificador: