Freigeben über

IAudioViewManagerService::SetAudioStreamWindow-Methode (audioclient.h)

  • Artikel

Ordnet den angegebenen HWND Fensterhandle einem Audiodatenstrom zu.

Syntax

HRESULT SetAudioStreamWindow(
  HWND hwnd
);

Parameter

hwnd

Der HWND-, dem der Audiodatenstrom zugeordnet werden soll.

Bemerkungen

Eine App kann audiostreams einem bestimmten Fenster ihrer App zuordnen, um eine ordnungsgemäße Audiospeicherortdarstellung in einem Mixed Reality-Szenario zu ermöglichen.

Rufen Sie eine Instanz des IAudioViewManagerService- ab, indem Sie GetService- für die IAudioClient-Instanz aufrufen, die den Datenstrom darstellt, dem Sie ein Fenster zuordnen möchten. Das folgende Codebeispiel veranschaulicht das Erstellen eines Audiodatenstroms auf dem Standardmäßigen Audiowiedergabeendpunkt und das Zuordnen zu einem HWND-.

#include <audioclient.h>

HRESULT CreateAudioStreamAndAttachToHwnd(_In_ HWND hwnd, _Out_ IAudioClient **audioStream)
{

    wil::com_ptr_nothrow<IMMDeviceEnumerator> enumerator;
    RETURN_IF_FAILED(CoCreateInstance(__uuidof(IMMDeviceEnumerator),
    NULL,
    CLSCTX_ALL,
    IID_PPV_ARGS(&enumerator)));
    
    wil::com_ptr_nothrow<IMMDevice> device;
    RETURN_IF_FAILED(enumerator->GetDefaultAudioEndpoint(eRender, eConsole, &device));
    
    wil::com_ptr_nothrow<IAudioClient> audioClient;
    RETURN_IF_FAILED(device->Activate(__uuidof(IAudioClient),
    CLSCTX_ALL,
    NULL,
    (void**)&audioClient));
    
    wil::unique_cotaskmem_ptr<WAVEFORMATEX> wfx;
    RETURN_IF_FAILED(audioClient->GetMixFormat(wil::out_param_ptr<WAVEFORMATEX**>(wfx)));
    
    constexpr REFERENCE_TIME hnsRequestedDuration = 10000000;
    RETURN_IF_FAILED(audioClient->Initialize(AUDCLNT_SHAREMODE_SHARED,
    0,
    hnsRequestedDuration,
    0,
    wfx.get(),
    NULL));
    
    wil::com_ptr_nothrow<IAudioViewManagerService> audioViewManagerService;
    RETURN_IF_FAILED(audioClient->GetService(IID_PPV_ARGS(&audioViewManagerService)));
    RETURN_IF_FAILED(audioViewManagerService->SetAudioStreamWindow(hwnd));
    
    *audioStream = spAudioClient.detach();
    
    return S_OK;
}

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Build 22621
mindestens unterstützte Server- Windows Server, Version 23H2
Header- audioclient.h