Conjuntos de propriedades do minidriver do decodificador de DVD
Esta seção descreve conjuntos de propriedades específicos do decodificador de DVD que estão disponíveis para minidrivers de decodificador de DVD que usam serviços de streaming de kernel do 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.
| 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)
Esse é o objeto KS para o qual a solicitação de propriedade é enviada. O destino de uma propriedade de decodificador de DVD é um filtro ou um pin. (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 booliano. Uma propriedade que pode assumir valores inteiros de 0 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 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 pin provavelmente exigirá apenas uma operação get. Uma propriedade que representa uma configuração configurável pode exigir apenas uma operação definida, 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 de decodificador de DVD, consulte Propriedades do KS.
Propriedades consultam ou alteram aspectos do fluxo. Vários conjuntos de propriedades são usados para decodificadores de DVD. Todos os fluxos de entrada do decodificador de DVD dão suporte ao conjunto de propriedades de proteção de direitos autorais de DVD, além dos conjuntos de propriedades descritos neste tópico
Cada descrição da propriedade contém uma tabela que indica se os minidrivers de decodificador de DVD são necessários para dar suporte à leitura ou gravação da propriedade. Os minidrivers de decodificador de DVD 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 seguintes conjuntos de propriedades são definidos para minidrivers de decodificador de DVD: