Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Esta seção descreve os conjuntos de propriedades específicas da API do codificador e do 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 para cada propriedade contém uma tabela com os cabeçalhos de coluna mostrados abaixo.
| Get | Set | Target | Tipo de descritor de propriedade | Tipo de valor da propriedade |
|---|---|---|---|---|
Estas rubricas têm os seguintes significados:
Get
O objeto KS de destino suporta a solicitação de propriedade KSPROPERTY_TYPE_GET?
Set
O objeto KS de destino suporta a solicitação de propriedade KSPROPERTY_TYPE_SET?
Target
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 ser executada nessa propriedade. The descriptor always begins with a KSPROPERTY structure.
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 - on ou off - normalmente tem um valor BOOL. Uma propriedade que pode assumir valores inteiros de 0x0 a 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 que sã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 a ser executada na propriedade:
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
Todos os objetos de filtro e pino suportam a operação de suporte básico em suas propriedades. Whether they support the get and Set operations depends on the property. A property that represents an inherent capability of the filter or pin object is likely to require only a get operation. A property that represents a configurable setting might require only a Set operation, although a get operation might also be useful for reading the current setting. For more information about using the get, set, and basic-support operations with video encoder properties, see KS Properties.
Uma tabela na descrição de cada propriedade indica se minidrivers de codificador de vídeo são necessários para suportar a leitura ou gravação da propriedade. Minidrivers de codificador de vídeo devem retornar STATUS_NOT_SUPPORTED em resposta para obter ou definir solicitações de propriedades que não são suportadas pelo minidriver.
Cada conjunto de propriedades a seguir contém uma única propriedade que deve ser implementada por minidrivers de codificador de vídeo. That is, effectively each property gets its own set, so specify 0 in the PropertyId member of the KSPROPERTY_ITEM member in the KSPROPERTY_SET structure as required.
Os seguintes conjuntos de propriedades pertencem à API do codec:
Os seguintes conjuntos de propriedades pertencem à API do codificador: