Conjuntos de propriedades do minidriver do decodificador de DVD

Esta seção descreve conjuntos de propriedades específicas 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.

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 de decodificador de DVD é 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 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 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. Uma propriedade que representa uma funcionalidade inerente do objeto de filtro ou pin provavelmente exigirá apenas uma operação de obtenção. 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. For more information about using the get, set, and basic-support operations with DVD decoder properties, see KS Properties.

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 do 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 do decodificador de DVD são necessários para dar suporte à leitura ou gravação da propriedade. Os minidrivers do 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:

KSPROPSETID_AudioDecoderOut

KSPROPSETID_DvdSubPic

KSPROPSETID_CopyProt

KSPROPSETID_TSRateChange

KSPROPSETID_VPConfig e KSPROPSETID_VPVBIConfig

KSPROPSETID_Wave