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)