Поделиться через

структура DIRECTX_AUDIO_ACTIVATION_PARAMS (mmdeviceapi.h)

  • Статья

Структура DIRECTX_AUDIO_ACTIVATION_PARAMS задает параметры инициализации для потока DirectSound.

Синтаксис

typedef struct tagDIRECTX_AUDIO_ACTIVATION_PARAMS {
  DWORD cbDirectXAudioActivationParams;
  GUID  guidAudioSession;
  DWORD dwAudioStreamFlags;
} DIRECTX_AUDIO_ACTIVATION_PARAMS, *PDIRECTX_AUDIO_ACTIVATION_PARAMS;

Члены

cbDirectXAudioActivationParams

Размер структуры DIRECTX_AUDIO_ACTIVATION_PARAMS в байтах. Задайте для этого элемента значение sizeof(DIRECTX_AUDIO_ACTIVATION_PARAMS).

guidAudioSession

Идентификатор GUID сеанса. Этот элемент представляет собой значение GUID, определяющее звуковой сеанс, к которому принадлежит поток. Если GUID идентифицирует ранее открытый сеанс, метод добавляет поток в этот сеанс. Если GUID не идентифицирует существующий сеанс, метод открывает новый сеанс и добавляет поток в этот сеанс. Поток остается членом одного и того же сеанса в течение своего времени существования.

dwAudioStreamFlags

Флаги инициализации потока. Этот элемент указывает, принадлежит ли поток сеансу между процессами или сеансу, относящегося к текущему процессу. Задайте для этого элемента значение 0 или следующую константу AUDCLNT_STREAMFLAGS_XXX :

AUDCLNT_STREAMFLAGS_CROSSPROCESS

Комментарии

Эта структура используется методом IMMDevice::Activate . При активации интерфейса IDirectSound, IDirectSoundCapture или IBaseFilter на устройстве конечной точки аудио структура DIRECTX_AUDIO_ACTIVATION_PARAMS задает guid сеанса и флаги инициализации потока для аудиопотока, который модуль DirectSound создает и инкапсулирует в экземпляре интерфейса. Во время вызова Activate DirectSound вызывает метод IAudioClient::Initialize и задает guid сеанса и флаги инициализации потока из структуры DIRECTX_AUDIO_ACTIVATION_PARAMS в качестве входных параметров.

Дополнительные сведения об IDirectSound, IDirectSoundCapture и IBaseFilter см. в документации по windows SDK.

Пример кода, в котором используется структура DIRECTX_AUDIO_ACTIVATION_PARAMS , см. в разделе Роли устройств для приложений DirectShow.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть mmdeviceapi.h

См. также раздел

Основные звуковые структуры

IAudioClient::Initialize

IMMDevice::Activate