структура HDAUDIO_BUS_INTERFACE_V2 (hdaudio.h)
Структура 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 .
Комментарии
IRP_MN_QUERY_INTERFACE IOCTL использует эту структуру для предоставления сведений об интерфейсе клиенту, который запрашивает драйвер шины HD Audio для DDI HD Audio.
Имена и определения первых пяти элементов структуры HDAUDIO_BUS_INTERFACE_V2 (Размер, Версия, Контекст, InterfaceReference и InterfaceDereference) совпадают с именами и определениями в структуре INTERFACE . Остальные члены относятся к базовому hd Audio DDI и указывают указатели на функции для подпрограмм в DDI.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows Vista и более поздних версиях Windows. |
| Верхняя часть | hdaudio.h (включая Hdaudio.h) |