IAudioRenderClient-Schnittstelle (audioclient.h)
Die IAudioRenderClient-Schnittstelle ermöglicht es einem Client, Ausgabedaten in einen Renderingendpunktpuffer zu schreiben. Der Client ruft einen Verweis auf die IAudioRenderClient-Schnittstelle eines Streamobjekts ab, indem er die IAudioClient::GetService-Methode aufruft, wobei der Parameter riid auf REFIID IID_IAudioRenderClient festgelegt ist.
Die Methoden in dieser Schnittstelle verwalten die Bewegung von Datenpaketen, die Audiorenderingdaten enthalten. Die Länge eines Datenpakets wird als die Anzahl der Audioframes im Paket ausgedrückt. Die Größe eines Audioframes wird durch das nBlockAlign-Element der WAVEFORMATEX-Struktur angegeben, das der Client durch Aufrufen der IAudioClient::GetMixFormat-Methode erhält. Die Größe eines Audioframes in Bytes entspricht der Anzahl von Kanälen im Stream multipliziert mit der Beispielgröße pro Kanal. Beispielsweise beträgt die Framegröße vier Bytes für einen Stereodatenstrom (2 Kanäle) mit 16-Bit-Beispielen. Ein Paket enthält immer eine integrale Anzahl von Audioframes.
Beim Freigeben einer IAudioRenderClient-Schnittstelle instance muss der Client die Release-Methode der Schnittstelle aus demselben Thread aufrufen wie der Aufruf von IAudioClient::GetService, der das Objekt erstellt hat.
Codebeispiele, die die IAudioRenderClient-Schnittstelle verwenden, finden Sie in den folgenden Themen:
Vererbung
Die IAudioRenderClient-Schnittstelle erbt von der IUnknown-Schnittstelle . IAudioRenderClient verfügt auch über die folgenden Membertypen:
Methoden
Die IAudioRenderClient-Schnittstelle verfügt über diese Methoden.
| IAudioRenderClient::GetBuffer Ruft einen Zeiger auf den nächsten verfügbaren Speicherplatz im Renderingendpunktpuffer ab, in den der Aufrufer ein Datenpaket schreiben kann. |
| IAudioRenderClient::ReleaseBuffer Die ReleaseBuffer-Methode gibt den Pufferspeicher frei, der beim vorherigen Aufruf der IAudioRenderClient::GetBuffer-Methode abgerufen wurde. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | audioclient.h |