Compartir a través de


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 minidriveres 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.

Get Set Target 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?

  • Set

    ¿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. 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 propiedad

    Una propiedad tiene un valor y el tipo de este valor depende de la propiedad . Por ejemplo, una propiedad que solo puede estar en uno de los dos estados activados o desactivados 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 anteriores son las versiones específicas de la propiedad de los búferes de especificación de instancia y operation-data que KS Properties, Events y Methods describen.

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. Whether they support the get and Set operations depends on the property. Es probable que una propiedad que represente una funcionalidad inherente del objeto filter o pin solo requiera una operación get. 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 descripción de propiedad contiene una tabla que indica si los minidrives de captura de vídeo deben admitir la lectura o escritura de la propiedad. Los minidriveres de captura de vídeo deben devolver STATUS_NOT_SUPPORTED en respuesta a las solicitudes get o set para las propiedades que no son compatibles con el minidriver.

En la lista siguiente se describen los conjuntos de propiedades de streaming de kernel que usan los minidrivers de captura de vídeo:

PROPSETID_ALLOCATOR_CONTROL

PROPSETID_EXT_DEVICE

PROPSETID_EXT_TRANSPORT

PROPSETID_TIMECODE_READER

PROPSETID_TUNER

PROPSETID_VIDCAP_CAMERACONTROL

KSPROPERTYSETID_ExtendedCameraControl

PROPSETID_VIDCAP_CROSSBAR

PROPSETID_VIDCAP_DROPPEDFRAMES

PROPSETID_VIDCAP_TVAUDIO

PROPSETID_VIDCAP_VIDEOCOMPRESSION

PROPSETID_VIDCAP_VIDEOCONTROL

PROPSETID_VIDCAP_VIDEODECODER

PROPSETID_VIDCAP_VIDEOPROCAMP

Los siguientes conjuntos de propiedades se pueden usar con el controlador de clase de vídeo USB:

PROPSETID_VIDCAP_CAMERACONTROL

KSPROPERTYSETID_ExtendedCameraControl

PROPSETID_VIDCAP_VIDEOPROCAMP

PROPSETID_VIDCAP_SELECTOR