Partager via


KSPROPERTY_PIN_PROPOSEDATAFORMAT

Les clients utilisent la propriété KSPROPERTY_PIN_PROPOSEDATAFORMAT pour déterminer si les broches instanciées par la fabrique de broches prennent en charge un format de données spécifique.

Tableau récapitulatif de l’utilisation

Obtenir Définissez Cible Type de descripteur de propriété Type de valeur de propriété
Oui Oui Filtrer KSP_PIN KSDATAFORMAT

Notes

KSPROPERTY_PIN_PROPOSEDATAFORMAT inclut une structure de type KSDATAFORMAT, spécifiant le format de données proposé. Spécifiez cette propriété à l’aide de KSP_PIN, où le membre spécifie la fabrique de broches appropriée.

L’utilisation de KSPROPERTY_TYPE_GET avec cette propriété permet au pilote audio de fournir des informations sur le format de données par défaut sur une broche. KSPROPERTY_TYPE_GET est facultatif à implémenter pour cette propriété, sauf si le pilote prend en charge KSEVENT_PINCAPS_FORMATCHANGE.

Le filtre KS retourne STATUS_SUCCESS lors de l’utilisation de cette propriété avec KSPROPERTY_TYPE_SET si les broches peuvent être définies sur ou ouvertes avec le format de données proposé. Si l’épingle ne peut pas être définie sur le format de données proposé, elle retourne STATUS_NO_MATCH. Pour tout autre échec, une erreur appropriée est retournée. Si le pilote prend en charge KSPROPERTY_AUDIOSIGNALPROCESSING_MODES, cette propriété doit retourner STATUS_SUCCESS si le format est pris en charge par l’un des modes de traitement du signal audio.

L’utilisation de KSPROPERTY_TYPE_SET avec cette propriété ne modifie pas réellement le format des données. Les clients utilisent KSPROPERTY_CONNECTION_DATAFORMAT pour modifier le format des données. KSPROPERTY_TYPE_SET est facultatif à implémenter pour cette propriété.

Spécifications

En-tête : ks.h (include Ks.h)

Voir aussi

KSP_PIN

KSDATAFORMAT

KSEVENT_PINCAPS_FORMATCHANGE

Propriétés KS

KSPROPERTY

KSPROPERTY_AUDIOSIGNALPROCESSING_MODES