Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gibt Merkmale an, die ein Client während der Initialisierung des Datenstroms einem Audiodatenstrom zuweisen kann.
| Konstante/Wert | Description |
|---|---|
|
Der Audiodatenstrom ist Mitglied einer prozessübergreifenden Audiositzung. Weitere Informationen finden Sie in den Hinweisen. |
|
Der Audiodatenstrom wird im Loopbackmodus ausgeführt. Weitere Informationen finden Sie in den Hinweisen. |
|
Die Verarbeitung des Audiopuffers durch den Client wird ereignisgesteuert. Weitere Informationen finden Sie in den Hinweisen. |
|
Die Lautstärke- und Stummschaltungseinstellungen für eine Audiositzung bleiben bei Anwendungsneustarts nicht erhalten. Weitere Informationen finden Sie in den Hinweisen. |
|
Diese Konstante ist neu in Windows 7. Die Abtastrate des Datenstroms wird an eine von einer Anwendung angegebene Rate angepasst. Weitere Informationen finden Sie in den Hinweisen. |
|
Ein Kanalmatrixer und ein Samplerate-Konverter werden bei Bedarf eingefügt, um zwischen dem nicht komprimierten Format in IAudioClient::Initialize und dem Audiomodul-Mixformat zu konvertieren. |
|
Bei Verwendung mit AUDCLNT_STREAMFLAGS_AUTOCONVERTPCM wird ein Samplerate-Konverter mit besserer Qualität als die Standardkonvertierung verwendet, aber mit höheren Leistungskosten wird verwendet. Dies sollte verwendet werden, wenn die Audiodaten letztendlich vom Menschen gehört werden sollen, im Gegensatz zu anderen Szenarien wie dem Pumpen der Stille oder dem Auffüllen eines Zählers. |
Bemerkungen
Die IAudioClient::Initialize-Methode und die DIRECTX_AUDIO_ACTIVATION_PARAMS Struktur verwenden die AUDCLNT_STREAMFLAGS_XXX Konstanten.
Das flag AUDCLNT_STREAMFLAGS_CROSSPROCESS gibt an, dass die Audiositzung für den Datenstrom eine prozessübergreifende Sitzung ist. Eine prozessübergreifende Sitzung kann Datenströme aus mehreren Prozessen akzeptieren. Wenn zwei Anwendungen in zwei separaten Prozessen IAudioClient::Initialize mit identischen Sitzungs-GUIDs aufrufen und beide Anwendungen das AUDCLNT_SHAREMODE_CROSSPROCESS Flag festlegen, weist das Audiomodul ihre Datenströme derselben prozessübergreifenden Sitzung zu. Dieses Flag setzt das Standardverhalten außer Kraft, das den Datenstrom einer prozessspezifischen Sitzung statt einer prozessübergreifenden Sitzung zuweist. Das AUDCLNT_STREAMFLAGS_CROSSPROCESS Flag-Bit ist nicht mit dem Exklusivmodus kompatibel. Weitere Informationen zu prozessübergreifenden Sitzungen finden Sie unter Audiositzungen.
Das AUDCLNT_STREAMFLAGS_LOOPBACK-Flag ermöglicht die Loopbackaufzeichnung. Bei der Loopbackaufzeichnung kopiert das Audiomodul den Audiodatenstrom, der von einem Renderingendpunktgerät wiedergegeben wird, in einen Audioendpunktpuffer, sodass ein WASAPI-Client den Datenstrom erfassen kann. Wenn dieses Flag festgelegt ist, versucht die IAudioClient::Initialize-Methode , einen Aufnahmepuffer auf dem Renderinggerät zu öffnen. Dieses Flag ist nur für ein Renderinggerät gültig und nur, wenn der Initialize-Aufruf den ShareMode-Parameter auf AUDCLNT_SHAREMODE_SHARED festlegt. Andernfalls schlägt der Initialize-Aufruf fehl. Wenn der Aufruf erfolgreich ist, kann der Client die IAudioClient::GetService-Methode aufrufen, um eine IAudioCaptureClient-Schnittstelle auf dem Renderinggerät abzurufen. Weitere Informationen finden Sie unter Loopback-Aufzeichnung.
Das AUDCLNT_STREAMFLAGS_EVENTCALLBACK-Flag ermöglicht die ereignisgesteuerte Pufferung. Wenn ein Client dieses Flag im Aufruf von IAudioClient::Initialize festlegt, der einen Datenstrom initialisiert, muss der Client anschließend die IAudioClient::SetEventHandle-Methode aufrufen, um ein Ereignishandle für den Datenstrom anzugeben. Nach dem Start des Datenstroms signalisiert das Audiomodul das Ereignishandle, um den Client jedes Mal zu benachrichtigen, wenn ein Puffer für den Client verarbeitet werden kann. WASAPI unterstützt ereignisgesteuerte Puffer für Render- und Aufnahmepuffer. Sowohl der gemeinsam genutzte Modus als auch der Exklusivmodusdatenströme können ereignisgesteuerte Puffer verwenden. Ein Codebeispiel, das das AUDCLNT_STREAMFLAGS_EVENTCALLBACK-Flag verwendet, finden Sie unter Exclusive-Mode Streams.
Das flag AUDCLNT_STREAMFLAGS_NOPERSIST deaktiviert die Persistenz des Volumes und die Stummschaltungseinstellungen für eine Sitzung, die Renderingdatenströme enthält. Standardmäßig sind die Volumeebene und der Stummschaltungszustand für eine Renderingsitzung über Anwendungsneustarts hinweg persistent. Die Lautstärke und der Stummschaltungszustand für eine Aufnahmesitzung sind nie persistent. Weitere Informationen zur Persistenz von Sitzungslautstärke und Einstellungen für die Stummschaltung finden Sie unter Audiositzungen.
Mit dem AUDCLNT_STREAMFLAGS_RATEADJUST-Flag kann eine Anwendung einen Verweis auf die IAudioClockAdjustment-Schnittstelle abrufen, die zum Festlegen der Samplerate für den Datenstrom verwendet wird. Um einen Zeiger auf diese Schnittstelle zu erhalten, muss eine Anwendung den Audioclient mit diesem Flag initialisieren und dann IAudioClient::GetService aufrufen, indem der IID_IAudioClockAdjustment-Bezeichner angegeben wird. Rufen Sie zum Festlegen der neuen Beispielrate IAudioClockAdjustment::SetSampleRate auf. Dieses Kennzeichen ist nur für ein Renderinggerät gültig. Andernfalls schlägt der GetService-Aufruf mit dem Fehlercode AUDCLNT_E_WRONG_ENDPOINT_TYPE fehl. Die Anwendung muss auch den ShareMode-Parameter während des Initialize-Aufrufs auf AUDCLNT_SHAREMODE_SHARED festlegen. SetSampleRate schlägt fehl, wenn sich der Audioclient nicht im freigegebenen Modus befindet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Minimal unterstützter Client |
Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützter Mindestserver |
Windows Server 2008 [Desktop-Apps | UWP-Apps] |
| Header |
|