Conjuntos de propiedades minidriver de captura de vídeo
En esta sección se describen los conjuntos de propiedades específicas de captura de vídeo que están disponibles para minidrivers de captura de vídeo que usan servicios de streaming de kernel de WDM en Microsoft Windows XP, Windows 2000 y Windows 98/Me y sistemas operativos posteriores.
La página de referencia de cada propiedad contiene una tabla con los encabezados de columna siguientes.
Obtener | Set | Destino | Tipo de descriptor de propiedad | Tipo de valor de propiedad |
---|---|---|---|---|
Estos encabezados tienen los siguientes significados:
Get
¿El objeto KS de destino admite la solicitud de propiedad KSPROPERTY_TYPE_GET?
Establecimiento
¿El objeto KS de destino admite la solicitud de propiedad KSPROPERTY_TYPE_SET?
Target
El destino es el objeto KS al que se envía la solicitud de propiedad. El destino de una propiedad de captura de vídeo es un filtro o un pin. (La solicitud de propiedad especifica el objeto de destino por su identificador de kernel).
Tipo de descriptor de propiedad
El descriptor de propiedad especifica la propiedad y la operación que se va a realizar en esa propiedad. El descriptor siempre comienza con una estructura KSPROPERTY , pero algunos tipos de descriptor contienen información adicional. Por ejemplo, la estructura KSNODEPROPERTY es un descriptor de propiedad que comienza con una estructura KSPROPERTY, pero que también incluye un identificador de nodo.
Tipo de valor de propiedad
Una propiedad tiene un valor y el tipo de este valor depende de la propiedad . Por ejemplo, una propiedad que puede estar en uno de solo dos estados,activado o desactivado, normalmente tiene un valor BOOL. Una propiedad que puede suponer valores enteros de 0x0 a 0xFFFFFFFF podría tener un valor de ULONG. Las propiedades más complejas pueden tener valores que son matrices o estructuras.
El descriptor de propiedad y el valor de propiedad anterior son las versiones específicas de la propiedad de los búferes de búferes de especificaciones de instancia y datos de operación que KS Properties, Events y Methods tratan.
Una solicitud de propiedad usa una de las marcas siguientes para especificar la operación que se va a realizar en la propiedad :
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
Todos los objetos de filtro y anclaje admiten la operación de compatibilidad básica en sus propiedades. Si admiten las operaciones get y Set depende de la propiedad . Es probable que una propiedad que represente una funcionalidad inherente del objeto filter o pin solo requiera una operación get. Una propiedad que representa un valor configurable podría requerir solo una operación Set , aunque una operación get también podría ser útil para leer la configuración actual. Para obtener más información sobre el uso de las operaciones de obtención, establecimiento y soporte técnico básico con propiedades de captura de vídeo, vea Propiedades de KS.
Cada descripción de propiedad contiene una tabla que indica si los minidrivers de captura de vídeo deben admitir la lectura o escritura de la propiedad. Los minidrivers de captura de vídeo deben devolver STATUS_NOT_SUPPORTED en respuesta a obtener o establecer solicitudes de propiedades que no son compatibles con el minidriver.
En la lista siguiente se describen los conjuntos de propiedades de streaming del kernel que usan los minidrivers de captura de vídeo:
PROPSETID_VIDCAP_CAMERACONTROL
KSPROPERTYSETID_ExtendedCameraControl
PROPSETID_VIDCAP_DROPPEDFRAMES
PROPSETID_VIDCAP_VIDEOCOMPRESSION
Los siguientes conjuntos de propiedades se pueden usar con el controlador de clase de vídeo USB:
PROPSETID_VIDCAP_CAMERACONTROL