Jeux de propriétés minidriver de capture vidéo
Cette section décrit les ensembles de propriétés spécifiques à la capture vidéo disponibles pour les mini-disques de capture vidéo qui utilisent les services de diffusion en continu du noyau WDM dans les systèmes d’exploitation Microsoft Windows XP, Windows 2000 et Windows 98/Me et versions ultérieures.
La page de référence de chaque propriété contient une table avec les en-têtes de colonne suivants.
| Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
Ces titres ont les significations suivantes :
Get
L’objet KS cible prend-il en charge la demande de propriété KSPROPERTY_TYPE_GET ?
Définir
L’objet KS cible prend-il en charge la demande de propriété KSPROPERTY_TYPE_SET ?
Cible
La cible est l’objet KS auquel la demande de propriété est envoyée. La cible d’une propriété de capture vidéo est un filtre ou une broche. (La demande de propriété spécifie l’objet cible par son handle de noyau.)
Type de descripteur de propriété
Le descripteur de propriété spécifie la propriété et l’opération à effectuer sur cette propriété. Le descripteur commence toujours par une structure KSPROPERTY , mais certains types de descripteurs contiennent des informations supplémentaires. Par exemple, la structure KSNODEPROPERTY est un descripteur de propriété qui commence par une structure KSPROPERTY, mais inclut également un identificateur de nœud.
Type de valeur de propriété
Une propriété a une valeur et le type de cette valeur dépend de la propriété . Par exemple, une propriété qui peut se trouver dans l’un des deux états (activé ou désactivé) a généralement une valeur BOOL. Une propriété qui peut supposer des valeurs entières de 0x0 à 0xFFFFFFFF peut avoir une valeur ULONG. Les propriétés plus complexes peuvent avoir des valeurs qui sont des tableaux ou des structures.
Le descripteur de propriété et la valeur de la propriété ci-dessus sont les versions spécifiques à la propriété des instance-spécification et des mémoires tampons de données d’opération que KS Properties, Events et Methods traite.
Une demande de propriété utilise l’un des indicateurs suivants pour spécifier l’opération à effectuer sur la propriété :
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
Tous les objets de filtre et d’épingle prennent en charge l’opération de prise en charge de base sur leurs propriétés. La prise en charge des opérations get et Set dépend de la propriété . Une propriété qui représente une fonctionnalité inhérente de l’objet de filtre ou d’épingle est susceptible de nécessiter uniquement une opération get. Une propriété qui représente un paramètre configurable peut nécessiter uniquement une opération Set , bien qu’une opération get puisse également être utile pour lire le paramètre actuel. Pour plus d’informations sur l’utilisation des opérations get, set et basic-support avec les propriétés de capture vidéo, consultez Propriétés KS.
Chaque description de propriété contient un tableau qui indique si les minidrivers de capture vidéo doivent prendre en charge la lecture ou l’écriture de la propriété. Les minidrivers de capture vidéo doivent retourner STATUS_NOT_SUPPORTED en réponse à l’obtention ou à la définition des demandes de propriétés qui ne sont pas prises en charge par le minidriver.
La liste suivante décrit les ensembles de propriétés de diffusion en continu du noyau que les minidrivers de capture vidéo utilisent :
PROPSETID_VIDCAP_CAMERACONTROL
KSPROPERTYSETID_ExtendedCameraControl
PROPSETID_VIDCAP_DROPPEDFRAMES
PROPSETID_VIDCAP_VIDEOCOMPRESSION
Les jeux de propriétés suivants peuvent être utilisés avec le pilote de classe vidéo USB :
PROPSETID_VIDCAP_CAMERACONTROL