структура HDAUDIO_BUS_INTERFACE_V2 (hdaudio.h)

Статья
08/07/2023

Структура HDAUDIO_BUS_INTERFACE_V2 указывает сведения, необходимые клиенту для вызова подпрограмм в HDAUDIO_BUS_INTERFACE_V2 версии HD Audio DDI. Интерфейс, представленный этой структурой, предоставляет все функциональные возможности HDAUDIO_BUS_INTERFACE , а также может поддерживать гибкие уведомления о событиях на основе DMA.

Синтаксис

typedef struct _HDAUDIO_BUS_INTERFACE_V2 {
  USHORT                                 Size;
  USHORT                                 Version;
  PVOID                                  Context;
  PINTERFACE_REFERENCE                   InterfaceReference;
  PINTERFACE_DEREFERENCE                 InterfaceDereference;
  PTRANSFER_CODEC_VERBS                  TransferCodecVerbs;
  PALLOCATE_CAPTURE_DMA_ENGINE           AllocateCaptureDmaEngine;
  PALLOCATE_RENDER_DMA_ENGINE            AllocateRenderDmaEngine;
  PCHANGE_BANDWIDTH_ALLOCATION           ChangeBandwidthAllocation;
  PALLOCATE_DMA_BUFFER                   AllocateDmaBuffer;
  PFREE_DMA_BUFFER                       FreeDmaBuffer;
  PFREE_DMA_ENGINE                       FreeDmaEngine;
  PSET_DMA_ENGINE_STATE                  SetDmaEngineState;
  PGET_WALL_CLOCK_REGISTER               GetWallClockRegister;
  PGET_LINK_POSITION_REGISTER            GetLinkPositionRegister;
  PREGISTER_EVENT_CALLBACK               RegisterEventCallback;
  PUNREGISTER_EVENT_CALLBACK             UnregisterEventCallback;
  PGET_DEVICE_INFORMATION                GetDeviceInformation;
  PGET_RESOURCE_INFORMATION              GetResourceInformation;
  PALLOCATE_DMA_BUFFER_WITH_NOTIFICATION AllocateDmaBufferWithNotification;
  PFREE_DMA_BUFFER_WITH_NOTIFICATION     FreeDmaBufferWithNotification;
  PREGISTER_NOTIFICATION_EVENT           RegisterNotificationEvent;
  PUNREGISTER_NOTIFICATION_EVENT         UnregisterNotificationEvent;
} HDAUDIO_BUS_INTERFACE_V2, *PHDAUDIO_BUS_INTERFACE_V2;

Члены

Size

Задает размер структуры HDAUDIO_BUS_INTERFACE_V2 в байтах.

Version

Указывает версию базового hd Audio DDI.

Context

Указатель на сведения о контексте для конкретного интерфейса.

InterfaceReference

Указатель на подпрограмму, предоставляемую драйвером, которая увеличивает число ссылок для интерфейса.

InterfaceDereference

Указатель на подпрограмму, предоставляемую драйвером, которая уменьшает количество ссылок для интерфейса.

TransferCodecVerbs

Указатель функции на подпрограмму TransferCodecVerbs .

AllocateCaptureDmaEngine

Указатель функции на подпрограмму AllocateCaptureDmaEngine .

AllocateRenderDmaEngine

Указатель функции на подпрограмму AllocateRenderDmaEngine .

ChangeBandwidthAllocation

Указатель функции на подпрограмму ChangeBandwidthAllocation .

AllocateDmaBuffer

Указатель функции на подпрограмму AllocateDmaBuffer .

FreeDmaBuffer

Указатель функции на подпрограмму FreeDmaBuffer .

FreeDmaEngine

Указатель функции на подпрограмму FreeDmaEngine .

SetDmaEngineState

Указатель функции на подпрограмму SetDmaEngineState .

GetWallClockRegister

Указатель функции на подпрограмму GetWallClockRegister .

GetLinkPositionRegister

Указатель функции на подпрограмму GetLinkPositionRegister .

RegisterEventCallback

Указатель функции на подпрограмму RegisterEventCallback .

UnregisterEventCallback

Указатель функции на подпрограмму UnregisterEventCallback .

GetDeviceInformation

Указатель функции на подпрограмму GetDeviceInformation .

GetResourceInformation

Указатель функции на подпрограмму GetResourceInformation .

AllocateDmaBufferWithNotification

Указатель функции на подпрограмму AllocateDmaBufferWithNotification .

FreeDmaBufferWithNotification

Указатель функции на подпрограмму FreeDmaBufferWithNotification .

RegisterNotificationEvent

Указатель функции на подпрограмму RegisterNotificationEvent .

UnregisterNotificationEvent

Указатель функции на подпрограмму UnregisterNotificationEvent .

Имена и определения первых пяти элементов структуры HDAUDIO_BUS_INTERFACE_V2 (Размер, Версия, Контекст, InterfaceReference и InterfaceDereference) совпадают с именами и определениями в структуре INTERFACE . Остальные члены относятся к базовому hd Audio DDI и указывают указатели на функции для подпрограмм в DDI.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях Windows.
Верхняя часть	hdaudio.h (включая Hdaudio.h)