KSPROPERTY_PIN_PROPOSEDATAFORMAT
I client usano la proprietà KSPROPERTY_PIN_PROPOSEDATAFORMAT per determinare se le aggiunte create dall'istanza della pin factory supportano un formato di dati specifico.
Tabella riepilogo utilizzo
| Recupero | Set | Destinazione | Tipo di descrittore delle proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
| Sì | Sì | Filtra | KSP_PIN | KSDATAFORMAT |
Commenti
KSPROPERTY_PIN_PROPOSEDATAFORMAT include una struttura di tipo KSDATAFORMAT, specificando il formato di dati proposto. Specificare questa proprietà usando KSP_PIN, in cui il membro specifica la data di aggiunta pertinente.
L'uso di KSPROPERTY_TYPE_GET con questa proprietà consente al driver audio di fornire informazioni sul formato dati predefinito in un pin. KSPROPERTY_TYPE_GET è facoltativo implementare per questa proprietà, a meno che il driver non supporti KSEVENT_PINCAPS_FORMATCHANGE.
Il filtro KS restituisce STATUS_SUCCESS quando si usa questa proprietà con KSPROPERTY_TYPE_SET se i pin possono essere impostati su o aperti con il formato di dati proposto. Se il pin non può essere impostato sul formato di dati proposto, restituisce STATUS_NO_MATCH. Per eventuali altri errori, viene restituito un errore appropriato. Se il driver supporta KSPROPERTY_AUDIOSIGNALPROCESSING_MODES, questa proprietà deve restituire STATUS_SUCCESS se il formato è supportato da una delle modalità di elaborazione del segnale audio.
L'uso di KSPROPERTY_TYPE_SET con questa proprietà non modifica effettivamente il formato dei dati. I client usano KSPROPERTY_CONNECTION_DATAFORMAT per modificare il formato dei dati. KSPROPERTY_TYPE_SET è facoltativo implementare per questa proprietà.
Requisiti
Intestazione: ks.h (includere Ks.h)