Interfaccia IKsFormatSupport (devicetopology.h)

L'interfaccia IKsFormatSupport fornisce informazioni sui formati di dati audio supportati da una connessione I/O configurata dal software (in genere un canale DMA) tra un dispositivo adattatore audio e la memoria di sistema. Il client ottiene un riferimento all'interfaccia IKsFormatSupport di una parte chiamando il metodo IPart::Activate con il parametro refiid impostato su REFIID IID_IKsFormatSupport. La chiamata a IPart::Activate ha esito positivo solo se la parte supporta l'interfaccia IKsFormatSupport . Solo un oggetto parte che rappresenta un connettore con un tipo di connessione Software_IO supporterà questa interfaccia. Per altre informazioni sulle Software_IO, vedere Enumerazione ConnectorType.

La maggior parte dei driver dell'adattatore audio di Windows supporta il modello di driver Windows (WDM) e usa le proprietà di streaming del kernel (KS) per rappresentare i parametri di descrizione hardware nei connettori (definiti pin KS). L'interfaccia IKsFormatSupport fornisce un accesso pratico alle proprietà KSPROPERTY_PIN_DATAINTERSECTION e KSPROPERTY_PIN_PROPOSEDDATAFORMAT di un connettore a un bus di sistema (in genere PCI o PCI Express) o a un bus esterno (ad esempio, USB). Non tutti i driver supportano la proprietà KSPROPERTY_PIN_PROPOSEDDATAFORMAT. Se un driver non supporta questa proprietà, IKsFormatSupport usa le informazioni negli intervalli di dati KS per il connettore per determinare se il connettore supporta il formato proposto. Per altre informazioni sulle proprietà KS, sui pin KS e sugli intervalli di dati KS, vedere la documentazione di Windows DDK.

Ereditarietà

L'interfaccia IKsFormatSupport eredita dall'interfaccia IUnknown . IKsFormatSupport include anche questi tipi di membri:

Metodi

L'interfaccia IKsFormatSupport include questi metodi.

 
IKsFormatSupport::GetDevicePreferredFormat

Il metodo GetDevicePreferredFormat ottiene il formato di flusso audio preferito per la connessione.
IKsFormatSupport::IsFormatSupported

Il metodo IsFormatSupported indica se il dispositivo endpoint audio supporta il formato di flusso audio specificato.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione devicetopology.h

Vedi anche

Interfacce audio di base

DeviceTopology API

IPart::Activate