DeviceTopology API
Microsoft yüksek kaliteli ses yakalama DMO örneğibakın.
DeviceTopology API,istemci uygulamalarına ses işleme ve yakalama cihazlarının işlevsel donanım topolojilerini dolaşma olanağı sağlar. deviceTopology API'sindeki arabirimler ve yöntemler aracılığıyla istemciler, ses uç noktası cihazlarına giden ve bu cihazlardan giden veri yolları boyunca uzanan işlevsel alt birimleri (örneğin, birim denetimi) bulabilir. İstemciler, hem ses bağdaştırıcısı cihazlarının hem de ses uç noktası cihazlarının iç topolojilerinden geçiş yapabilir ve bir cihazı başka bir cihaza bağlayan bağlantılar arasında geçiş yapabilir. Daha fazla bilgi için bkz. Cihaz Topolojileri.
Devicetopology.h üst bilgi dosyası, DeviceTopology API'sindeki arabirimleri tanımlar.
DeviceTopology API arabirimlerine erişmek için istemci, aşağıdaki adımları izleyerek önce bir ses uç noktası cihazı için IDeviceTopology arabirimine bir başvuru elde eder:
- IMMDevice Arabirimi'nde açıklanan tekniklerden birini kullanarak, bir ses uç noktası cihazı için IMMDevice arabirimine başvuru alın.
- IMMDevice::Activate yöntemini refiid IID_IDeviceTopology olarak ayarlanmış iid parametresiyle çağırın.
İstemci, IDeviceTopology arabirimindeki yöntemleri çağırarak DeviceTopology API'sindeki diğer arabirimlere başvurular alabilir.
DeviceTopology API'sinde aşağıdaki arabirimler uygulanır.
| Arayüz | Açıklama |
|---|---|
| IAudioAutoGainControl | Donanım otomatik kazanç denetimine (AGC) erişim sağlar. |
| IAudioBass | Donanım bas düzeyi denetimine erişim sağlar. |
| IAudioChannelConfig | Donanım kanalı yapılandırma denetimine erişim sağlar. |
| IAudioInputSelector | Donanım çoklayıcı denetimine (giriş seçici) erişim sağlar. |
| IAudioLoudness | "Ses" dengeleme denetimine erişim sağlar. |
| IAudioMidrange | Donanım orta düzey denetimine erişim sağlar. |
| IAudioMute | Donanım sessiz denetimine erişim sağlar. |
| IAudioOutputSelector | Donanım demultiplexer denetimine (çıkış seçici) erişim sağlar. |
| IAudioPeakMeter | Donanım en yüksek ölçüm denetimine erişim sağlar. |
| IAudioTreble | Donanım tiz düzeyi denetime erişim sağlar. |
| IAudioVolumeLevel | Donanım ses denetimine erişim sağlar. |
| IConnector | Bileşenler arasındaki bağlantı noktasını temsil eder. |
| IControlInterface | Bir parçadaki denetim arabirimini (alt birim veya bağlayıcı) temsil eder. |
| IDeviceSpecificProperty | Bağlayıcının veya alt birimin cihaza özgü özelliğini temsil eder. |
| IDeviceTopology | Ses cihazının topolojisine erişim sağlar. |
| IKsFormatSupport | Ses cihazı ve sistem belleği arasında yazılım tarafından yapılandırılmış G/Ç bağlantısı (genellikle bir DMA kanalı) tarafından desteklenen ses veri biçimleri hakkında bilgi sağlar. |
| IKsJackDescription | Ses bağdaştırıcısındaki bir cihaz ile dış veya iç uç nokta cihazı (örneğin, mikrofon veya CD oynatıcı) arasında fiziksel bağlantı sağlayan jaklar veya iç bağlayıcılar hakkında bilgi sağlar. |
| IPart | Cihaz topolojisinin bir bölümünü (bağlayıcı veya alt birim) temsil eder. |
| IPartsList | Parçaların (bağlayıcılar ve alt birimler) listesini temsil eder. |
| IPerChannelDbLevel | Ses akışındaki ses düzeyi, desibeller, bir ses akışı veya bir frekans bandı üzerinde kanal başına denetim sağlayan genel bir alt birim denetim arabirimini temsil eder. |
| ISubunit | İstemci ile ses uç noktası cihazı arasındaki veri yolunda bulunan bir donanım alt birimini (örneğin, birim düzeyi denetimi) temsil eder. |
Bağlayıcılarda ve alt birimlerde control-change olaylarının bildirimini gerektiren DeviceTopology API istemcileri aşağıdaki arabirimi uygulamalıdır.
| Arayüz | Açıklama |
|---|---|
| IControlChangeNotify | Bir parçanın (bağlayıcı veya alt birim) durumu değiştiğinde bildirim sağlar. |
İlgili konular