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 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 seguintes títulos de coluna.
| 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
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 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, but some types of descriptor contain additional information. For example, the KSNODEPROPERTY structure is a property descriptor that begins with a KSPROPERTY structure but also includes a node identifier.
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 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 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. 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 capture properties, see KS Properties.
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 têm suporte do 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