Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Esta seção descreve os conjuntos de propriedades específicos da API de codificador e codec que estão disponíveis para minidrivers codificadores que usam serviços de streaming de kernel WDM no Microsoft Windows 98/Me, Windows 2000 e Windows XP e posteriores.
A página de referência de cada propriedade contém uma tabela com os títulos de coluna mostrados abaixo.
| Get | Set | Target | Tipo de descritor de propriedade | Tipo de valor de propriedade |
|---|---|---|---|---|
Esses títulos têm os seguintes significados:
Get
O objeto KS de destino dá suporte à solicitação de propriedade KSPROPERTY_TYPE_GET?
Set
O objeto KS de destino dá suporte à 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 sua alça de kernel.)
Tipo de descritor de propriedade
O descritor de propriedade especifica a propriedade e a operação a serem executadas nessa propriedade. The descriptor always begins with a KSPROPERTY structure.
Tipo de valor de 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 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 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 pin dão suporte à 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 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. 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 codec:
Os seguintes conjuntos de propriedades pertencem à API do codificador: