Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette section décrit les ensembles de propriétés spécifiques à l’encodeur et à l’API codec disponibles pour les minidrivers d’encodeur qui utilisent des services de streaming 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 indiqués ci-dessous.
| Get | Set | Target | 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 ?
Set
L’objet KS cible prend-il en charge la demande de propriété KSPROPERTY_TYPE_SET ?
Target
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 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é. The descriptor always begins with a KSPROPERTY structure.
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 seuls é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 aux propriétés des mémoires tampons de spécification d’instance et de données d’opération décrites dans KS Properties, Events et 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 prise en charge de base sur leurs propriétés. Whether they support the get and Set operations depends on the property. A property that represents an inherent capability of the filter or pin object is likely to require only a get operation. 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 encoder properties, see KS Properties.
Une table de la description de chaque propriété indique si les minidrivers de l’encodeur vidéo sont nécessaires pour prendre en charge la lecture ou l’écriture de la propriété. Les minidrivers de l’encodeur vidéo doivent retourner STATUS_NOT_SUPPORTED en réponse à des demandes d’obtention ou de définition de propriétés qui ne sont pas prises en charge par le minidriver.
Les ensembles 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. That is, effectively each property gets its own set, so specify 0 in the PropertyId member of the KSPROPERTY_ITEM member in the KSPROPERTY_SET structure as required.
Les jeux de propriétés suivants appartiennent à l’API codec :
Les jeux de propriétés suivants appartiennent à l’API d’encodeur :