Conjuntos de Propriedades do Minidriver de Captura de Vídeo
Esta seção descreve os conjuntos de propriedades específicos da captura de vídeo que estão disponíveis para minidrivers de captura de vídeo que usam serviços de streaming de kernel WDM no Microsoft Windows XP, Windows 2000 e Windows 98/Me e sistemas operacionais posteriores.
A página de referência de cada propriedade contém uma tabela com os títulos de coluna a seguir.
| 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)
O destino é o objeto KS para o qual a solicitação de propriedade é enviada. O destino de uma propriedade de captura 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 , mas alguns tipos de descritor contêm informações adicionais. Por exemplo, a estrutura KSNODEPROPERTY é um descritor de propriedade que começa com uma estrutura KSPROPERTY, mas também inclui um identificador de nó.
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 pelas 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 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 de captura de vídeo, consulte Propriedades do KS.
Cada descrição da propriedade contém uma tabela que indica se os minidrivers de captura de vídeo devem dar suporte à leitura ou gravação da propriedade. Os minidrivers de captura 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.
A lista a seguir descreve os conjuntos de propriedades de streaming de kernel que os minidrivers de captura de vídeo usam:
PROPSETID_VIDCAP_CAMERACONTROL
KSPROPERTYSETID_ExtendedCameraControl
PROPSETID_VIDCAP_DROPPEDFRAMES
PROPSETID_VIDCAP_VIDEOCOMPRESSION
Os seguintes conjuntos de propriedades podem ser usados com o Driver de Classe de Vídeo USB:
PROPSETID_VIDCAP_CAMERACONTROL