Jeux de propriétés de l’encodeur
Cette section décrit les jeux de propriétés spécifiques à l’API de l’encodeur et du codec disponibles pour les minidrivers d’encodeur qui utilisent les services de diffusion en continu de noyau WDM dans Microsoft Windows 98/Me, Windows 2000 et Windows XP et versions ultérieures.
La page de référence de chaque propriété contient une table avec les en-têtes de colonne affichés ci-dessous.
| Obtenir | Définissez | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
Ces en-têtes 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
Il s’agit de l’objet KS auquel la demande de propriété est envoyée. La cible d’une propriété d’encodeur vidéo est un filtre ou une épingle. (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 .
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 propriété ci-dessus sont les versions spécifiques à la propriété des mémoires tampons de instance-spécification et de données d’opération qui sont décrites dans KS Properties, Events, and Methods.
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 support 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 d’encodeur vidéo, consultez Propriétés KS.
Un tableau dans la description de chaque propriété indique si les minidrivers d’encodeur vidéo sont nécessaires pour prendre en charge la lecture ou l’écriture de la propriété. Les minidrivers d’encodeur vidéo doivent retourner STATUS_NOT_SUPPORTED en réponse à l’obtention ou à la définition de demandes de propriétés qui ne sont pas prises en charge par le minidriver.
Les jeux de propriétés suivants contiennent chacun une propriété unique qui doit être implémentée par les minidrivers de l’encodeur vidéo. Autrement dit, chaque propriété obtient son propre jeu. Spécifiez donc 0 dans le membre PropertyId du membre KSPROPERTY_ITEM dans la structure KSPROPERTY_SET si nécessaire.
Les jeux de propriétés suivants appartiennent à l’API codec :
Les jeux de propriétés suivants appartiennent à l’API d’encodeur :