DirectSound Renderer-filter
[De functie die is gekoppeld aan deze pagina, DirectShow, is een verouderde functie. Het is vervangen door MediaPlayer, IMFMediaEngineen Audio/Video Capture in Media Foundation. Deze functies zijn geoptimaliseerd voor Windows 10 en Windows 11. Microsoft raadt ten zeerste aan om nieuwe code te gebruiken MediaPlayer, IMFMediaEngine en Audio/Video Capture in Media Foundation in plaats van DirectShow, indien mogelijk. Microsoft stelt voor dat bestaande code die gebruikmaakt van de verouderde API's, indien mogelijk opnieuw worden geschreven om de nieuwe API's te gebruiken.]
Dit filter geeft audio weer met DirectSound. Dit filter is momenteel de standaard audio-renderer voor waveform-geluid.
Naast de basismogelijkheden voor sound-rendering kan dit filter DirectSound-API-aanroepen verwerken. Gebruik de methoden IAMDirectSound om het venster in te stellen en op te halen waarmee het geluid wordt afgespeeld. De DirectSound Audio Renderer is het standaardfilter voor audioweergave voor DirectShow.
| Etiket | Waarde |
|---|---|
| Filterinterfaces | IAMAudioRendererStats, IAMClockSlave, IAMDirectSound, IAMResourceControl, IBaseFilter, IBasicAudio, IBasicAudio, IDirectSound3DBuffer, IDirectSound3dListener, IMediaPosition, IMediaSeeking, IQualityControl, IReferenceClock |
| Typen invoerpinmedia | Primair type: MEDIATYPE_AudioSubtypes:
|
| Invoerpininterfaces | IMemInputPin, IPin, IPinConnection, IQualityControl |
| Mediatypen voor vastmaken van uitvoer | Niet van toepassing. |
| Interfaces voor uitvoerpin | Niet van toepassing. |
| CLSID filteren | CLSID_DSoundRender |
| CLSID van eigenschappenpagina | CLSID_AudioProperties, CLSID_AudioRendererAdvancedProperties |
| Uitvoerbaar | quartz.dll |
| MERIT_PREFERRED | |
| filtercategorie | CLSID_AudioRendererCategory |
Opmerkingen
Dit filter fungeert als een wrapper voor een audioapparaat. Als u de audioapparaten wilt inventariseren die beschikbaar zijn op het systeem van de gebruiker, gebruikt u de ICreateDevEnum-interface met de categorie audio-renderer (CLSID_AudioRendererCategory). Voor elk audioapparaat bevat de categorie audio-renderer twee filterexemplaren. Een van deze komt overeen met de DirectSound Renderer en de andere komt overeen met het Audio Renderer (WaveOut) filter. Het DirectSound-exemplaar heeft de beschrijvende naam DirectSound: DeviceName, waarbij DeviceName de naam van het apparaat is. Het WaveOut-exemplaar heeft de beschrijvende naam DeviceName.
De categorie audio-renderer bevat twee extra filterexemplaren met de naam 'Default DirectSound Device' en 'Default WaveOut Device'. Deze komen overeen met het standaardgeluidsapparaat, zoals gekozen door de gebruiker via het Configuratiescherm. Ze zijn eigenlijk toewijzingen aan een van de paren die in de vorige alinea worden beschreven. Als het systeem bijvoorbeeld twee audioapparaten heeft, apparaat A en apparaat B, bevat de categorie audio-renderer het volgende:
- Apparaat A
- DirectSound: Apparaat A
- Apparaat B
- DirectSound: Apparaat B
- Standaard DirectSound-apparaat
- Standaard WaveOut-apparaat
Als de gebruiker Apparaat A als standaardapparaat heeft geselecteerd, is 'Standaard DirectSound Device' gelijk aan 'DirectSound: Device A' en 'Default WaveOut Device' is gelijk aan 'Device A'. Als de gebruiker Apparaat B als standaardapparaat selecteert, worden deze toewijzingen gewijzigd.
"Default DirectSound Device" wordt een verdiensten van MERIT_PREFERRED toegewezen. De anderen hebben MERIT_DO_NOT_USE. Daarom kiest Intelligent Connect altijd het standaard DirectSound-apparaat.
Het DirectSound Renderer-filter ondersteunt 3D-geluid via de DirectSound IDirectSound3DBuffer en IDirectSound3dListener interfaces. U kunt ook een query uitvoeren op het filter voor de huidige versies van deze interfaces, IDirectSound3DBuffer8 en IDirectSound3dListener8. Voer de grafiek uit voordat u methoden op deze interfaces aanroept.