共用方式為

串流音頻轉譯器

  • 發行項

串流音訊轉譯器 （SAR） 是轉譯音訊的媒體接收。 SAR 的每個實例都會轉譯單一音頻數據流。 若要轉譯多個數據流，請使用SAR的多個實例。

若要建立 SAR，請呼叫下列任一函式：

如果您要播放受保護的內容，則傳回啟用物件的第二個函式是必要的，因為啟用對象必須串行化為受保護的進程。 如需清楚的內容，您可以使用任一函式。

SAR 可以接收 PCM 或 IEEE 浮點格式的未壓縮音訊。 如果播放速率快或慢於 1×，SAR 會自動調整音調。

設定音訊轉譯器

SAR 支援數位組態屬性。 設定這些屬性的機制取決於您呼叫哪個函式來建立 SAR。 如果您使用 MFCreateAudioRenderer 函式，請執行下列動作：

  1. 呼叫 MFCreateAttributes來建立新的屬性存放區。
  2. 將屬性新增至屬性存放區。
  3. 將屬性存放區傳遞至 pAudioAttributes 參數中的 MFCreateAudioRenderer 函式。

如果您使用 MFCreateAudioRendererActivate 函式，函式會在 ppActivate 參數中傳回 IMFAttributes 介面的指標。 使用此指標來新增屬性。

如需組態屬性的清單，請參閱 音訊轉譯器屬性。

選取音訊端點裝置

音訊端點裝置 是轉譯或擷取音訊的硬體裝置。 範例包括喇叭、耳機、麥克風和CD播放機。 SAR 一律使用音訊轉譯裝置。 有兩種方式可以選取裝置。

第一種方法是使用 IMMDeviceEnumerator 介面來列舉系統上的音訊轉譯裝置。 此介面記載於核心音訊 API 檔中。

  1. 建立裝置列舉值物件。
  2. 使用裝置列舉值來列舉音頻轉譯裝置。 每個裝置都會以 IMMDevice 介面的指標來表示。
  3. 根據裝置屬性或用戶的選取範圍，選取裝置。
  4. 呼叫 IMMDevice：：GetId 以取得裝置識別碼。
  5. 將裝置識別碼設定為 MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID 屬性的值。

您可以透過 角色來指定音訊裝置，而不是列舉裝置。 音訊角色會識別使用方式的一般類別。 例如，主控台 角色是針對遊戲和系統通知所定義，而 多媒體 角色則針對音樂和電影定義。 每個角色都有一個指派給它的音頻轉譯裝置，而且使用者可以變更這些指派。 如果您指定裝置角色，SAR 會使用該角色指派的任何音訊裝置。 若要指定裝置角色，請設定 MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ROLE 屬性。

本節所列的兩個屬性互斥。 如果您未設定其中一個，SAR 會使用指派給 eConsole 角色的音訊裝置。

下列程式代碼會列舉音頻轉譯裝置，並將清單中的第一個裝置指派給SAR。 此範例會使用 MFCreateAudioRenderer 函式來建立 SAR。

#include <mmdeviceapi.h>

HRESULT hr = S_OK;

IMMDeviceEnumerator *pEnum = NULL;      // Audio device enumerator.
IMMDeviceCollection *pDevices = NULL;   // Audio device collection.
IMMDevice *pDevice = NULL;              // An audio device.
IMFAttributes *pAttributes = NULL;      // Attribute store.
IMFMediaSink *pSink = NULL;             // Streaming audio renderer (SAR)

LPWSTR wstrID = NULL;                   // Device ID.

// Create the device enumerator.
hr = CoCreateInstance(
    __uuidof(MMDeviceEnumerator), 
    NULL,
    CLSCTX_ALL, 
    __uuidof(IMMDeviceEnumerator), 
    (void**)&pEnum
    );

// Enumerate the rendering devices.
if (SUCCEEDED(hr))
{
    hr = pEnum->EnumAudioEndpoints(eRender, DEVICE_STATE_ACTIVE, &pDevices);
}

// Get ID of the first device in the list.
if (SUCCEEDED(hr))
{
    hr = pDevices->Item(0, &pDevice);
}

if (SUCCEEDED(hr))
{
    hr = pDevice->GetId(&wstrID);
}

// Create an attribute store and set the device ID attribute.
if (SUCCEEDED(hr))
{
    hr = MFCreateAttributes(&pAttributes, 2);
}

if (SUCCEEDED(hr))
{
    hr = pAttributes->SetString(
        MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID, 
        wstrID
        );
}

// Create the audio renderer.
if (SUCCEEDED(hr))
{
    hr = MFCreateAudioRenderer(pAttributes, &pSink);    
}

SAFE_RELEASE(pEnum);
SAFE_RELEASE(pDevices);
SAFE_RELEASE(pDevice); 
SAFE_RELEASE(pAttributes);
CoTaskMemFree(wstrID);

若要建立 SAR 的啟用物件，請將呼叫之後出現的程式代碼變更為下列 IMMDevice：：GetId：

IMFActivate *pActivate = NULL;          // Activation object.

if (SUCCEEDED(hr))
{
    hr = MFCreateAudioRendererActivate(&pActivate);    
}

if (SUCCEEDED(hr))
{
    hr = pActivate->SetString(
        MF_AUDIO_RENDERER_ATTRIBUTE_ENDPOINT_ID, 
        wstrID
        );
}

SAFE_RELEASE(pActivate);

選取音訊會話

音訊會話是應用程式可以共同管理的相關音訊串流群組。 應用程式可以控制每個會話的磁碟區層級和靜音狀態。 會話是由 GUID 所識別。 若要指定 SAR 的音訊會話，請使用 MF_AUDIO_RENDERER_ATTRIBUTE_SESSION_ID 屬性。 如果您未設定此屬性，SAR 會聯結該程式的預設會話，GUID_NULL所識別。

根據預設，音訊會話是進程特定的，這表示它只包含來自呼叫進程的數據流。 若要聯結跨行程工作階段，請使用 值設定 MF_AUDIO_RENDERER_ATTRIBUTE_FLAGS 屬性 MF_AUDIO_RENDERER_ATTRIBUTE_FLAGS_CROSSPROCESS。

建立 SAR 之後，您可以使用 IMFAudioPolicy 介面將會話加入會話群組，這些會話全都由控制面板中的相同磁碟區控件控制。 您也可以使用此介面來設定顯示在磁碟區控制項中的顯示名稱和圖示。

控制磁碟區層級

若要控制 SAR 音訊會話中所有數據流的主要音量層級，請使用 IMFSimpleAudioVolume介面。 若要控制個別數據流的磁碟區，或控制數據流內個別通道的磁碟區，請使用IMFAudioStreamVolume介面。 這兩個介面都是藉由 呼叫IMFGetService：：GetService來取得。 您可以直接在 SAR 上呼叫 GetService，或在媒體會話上呼叫它。 磁碟區層級會以衰減值表示。 針對每個通道，衰減等級是主要磁碟區和通道磁碟區的乘積。

音訊/視訊播放