KSPROPERTY_PIN_PROPOSEDATAFORMAT

Article
06/15/2023

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