hdaudio.h 标头

音频使用此标头。 有关详细信息，请参阅：

• 音频：

hdaudio.h 包含以下编程接口：

回调函数

PALLOCATE_CAPTURE_DMA_ENGINE AllocateCaptureDmaEngine 例程为捕获流分配 DMA 引擎。AllocateCaptureDmaEngine 例程的函数指针类型定义如下。
PALLOCATE_CONTIGUOUS_DMA_BUFFER AllocateContiguousDmaBuffer 例程分配由单个连续物理内存块组成的 DMA 缓冲区。AllocateContiguousDmaBuffer 例程的函数指针类型定义如下。
PALLOCATE_DMA_BUFFER AllocateDmaBuffer 例程为 DMA 引擎分配系统内存中的数据缓冲区。AllocateDmaBuffer 例程的函数指针类型定义如下。
PALLOCATE_DMA_BUFFER_WITH_NOTIFICATION AllocateDmaBufferWithNotification 例程为 DMA 引擎分配系统内存中的数据缓冲区。AllocateDmaBufferWithNotification 例程的函数指针类型定义如下。
PALLOCATE_RENDER_DMA_ENGINE AllocateRenderDmaEngine 例程为呈现流分配 DMA 引擎。AllocateRenderDmaEngine 例程的函数指针类型定义如下。
PCHANGE_BANDWIDTH_ALLOCATION ChangeBandwidthAllocation 例程更改 DMA 引擎在 HD Audio Link 上的带宽分配。ChangeBandwidthAllocation 例程的函数指针类型定义如下。
PFREE_CONTIGUOUS_DMA_BUFFER FreeContiguousDmaBuffer 例程释放通过调用 AllocateContiguousDmaBuffer 分配的 DMA 缓冲区和缓冲区描述符列表 (BDL) 。FreeContiguousDmaBuffer 例程的函数指针类型定义如下。
PFREE_DMA_BUFFER FreeDmaBuffer 例程释放先前通过调用 AllocateDmaBuffer 分配的 DMA 缓冲区。FreeDmaBuffer 例程的函数指针类型定义如下。
PFREE_DMA_BUFFER_WITH_NOTIFICATION FreeDmaBufferWithNotification 例程释放以前通过调用 AllocateDmaBufferWithNotification 分配的 DMA 缓冲区。FreeDmaBufferWithNotification 例程的函数指针类型定义如下。
PFREE_DMA_ENGINE FreeDmaEngine 例程释放以前通过调用 AllocateCaptureDmaEngine 或 AllocateRenderDmaEngine 分配的 DMA 引擎。FreeDmaEngine 例程的函数指针类型定义如下。
PGET_DEVICE_INFORMATION GetDeviceInformation 例程检索有关 HD 音频控制器设备的信息。GetDeviceInformation 例程的函数指针类型定义如下。
PGET_LINK_POSITION_REGISTER GetLinkPositionRegister 例程检索指向 DMA 引擎的链接位置寄存器的指针。GetLinkPositionRegister 例程的函数指针类型定义如下。
PGET_RESOURCE_INFORMATION GetResourceInformation 例程检索有关硬件资源的信息。GetResourceInformation 例程的函数指针类型定义如下。
PGET_WALL_CLOCK_REGISTER GetWallClockRegister 例程检索指向时钟寄存器的指针。GetWallClockRegister 例程的函数指针类型定义如下。
PHDAUDIO_BDL_ISR HDAudioBdlIsr 例程是每次在流上发生 IOC 中断时 HD Audio 总线驱动程序调用的 ISR。 它是PHDAUDIO_BDL_ISR类型的函数指针，定义如下。
PHDAUDIO_DMA_NOTIFICATION_CALLBACK HDAudio 编解码器 DMA 通知回调函数。
PHDAUDIO_TRANSFER_COMPLETE_CALLBACK HDAudio 编解码器传输完整回调函数。 PHDAUDIO_TRANSFER_COMPLETE_CALLBACK由PTRANSFER_CODEC_VERBS回调函数使用。
PHDAUDIO_UNSOLICITED_RESPONSE_CALLBACK HDAudio 编解码器未经请求的响应回调函数。 PREGISTER_EVENT_CALLBACK回调函数使用PHDAUDIO_UNSOLICITED_RESPONSE_CALLBACK。
PREGISTER_EVENT_CALLBACK RegisterEventCallback 例程为来自编解码器或编解码器的未经请求的响应注册回调例程。RegisterEventCallback 例程的函数指针类型定义如下。
PREGISTER_NOTIFICATION_CALLBACK RegisterNotificationCallback 例程注册回调例程，以便它可以接收具有更准确的计时信息的 DMA 进度通知。
PREGISTER_NOTIFICATION_EVENT RegisterNotificationEvent 例程注册内核事件，以便它可以接收 DMA 进度通知。RegisterNotificationEvent 例程的函数指针类型定义如下。
PSET_DMA_ENGINE_STATE SetDmaEngineState 例程将一个或多个 DMA 引擎的状态设置为“正在运行”、“已停止”、“已暂停”或“重置”状态。SetDmaEngineState 例程的函数指针类型定义如下。
PSETUP_DMA_ENGINE_WITH_BDL SetupDmaEngineWithBdl 例程设置 DMA 引擎以使用调用方分配的 DMA 缓冲区。SetupDmaEngineWithBdl 例程的函数指针类型定义如下。
PTRANSFER_CODEC_VERBS TransferCodecVerbs 例程将一个或多个命令传输到编解码器或编解码器，并检索对这些命令的响应。TransferCodecVerbs 例程的函数指针类型定义如下。
PUNREGISTER_EVENT_CALLBACK UnregisterEventCallback 例程删除先前通过调用 RegisterEventCallback 注册的事件回调的注册。UnregisterEventCallback 例程的函数指针类型定义如下。
PUNREGISTER_NOTIFICATION_CALLBACK PUNREGISTER_NOTIFICATION_CALLBACK回调函数删除以前通过调用 RegisterNotificationCallback 注册的通知回调例程的注册。
PUNREGISTER_NOTIFICATION_EVENT UnregisterNotificationEvent 例程删除以前通过调用 RegisterNotificationEvent 注册的事件的注册。UnregisterNotificationEvent 例程的函数指针类型定义如下。

结构

HDAUDIO_BUFFER_DESCRIPTOR HDAUDIO_BUFFER_DESCRIPTOR 结构指定缓冲区描述符，该描述符是 BDL) (缓冲区描述符列表中的条目。
HDAUDIO_BUS_INTERFACE HDAUDIO_BUS_INTERFACE 结构指定客户端在 HD Audio DDI HDAUDIO_BUS_INTERFACE 版本中调用例程所需的信息。 此 DDI 的另一个变体由 HDAUDIO_BUS_INTERFACE_BDL 结构指定。
HDAUDIO_BUS_INTERFACE_BDL HDAUDIO_BUS_INTERFACE_BDL 结构指定客户端调用 hd Audio DDI HDAUDIO_BUS_INTERFACE_BDL 版本中例程所需的信息。 此 DDI 的另一个变体由 HDAUDIO_BUS_INTERFACE 结构指定。
HDAUDIO_BUS_INTERFACE_V2 HDAUDIO_BUS_INTERFACE_V2 结构指定客户端在 hd Audio DDI HDAUDIO_BUS_INTERFACE_V2 版本中调用例程所需的信息。
HDAUDIO_BUS_INTERFACE_V3 详细了解：_HDAUDIO_BUS_INTERFACE_V3结构
HDAUDIO_CODEC_COMMAND HDAUDIO_CODEC_COMMAND 结构指定编解码器命令。
HDAUDIO_CODEC_RESPONSE HDAUDIO_CODEC_RESPONSE 结构指定对编解码器命令的响应或来自编解码器的未经请求的响应。
HDAUDIO_CODEC_TRANSFER HDAUDIO_CODEC_TRANSFER 结构指定编解码器命令和对该命令的响应。
HDAUDIO_CONVERTER_FORMAT HDAUDIO_CONVERTER_FORMAT 结构指定输入或输出转换器的 16 位编码流格式，如 Intel 高清晰度音频规范 (请参阅 Intel HD Audio 网站) 。
HDAUDIO_DEVICE_INFORMATION HDAUDIO_DEVICE_INFORMATION结构指定 HD 音频总线控制器的硬件功能。
HDAUDIO_DEVICE_INFORMATION_V2 HDAUDIO_DEVICE_INFORMATION_V2结构指定 HD 音频总线控制器的硬件功能。
HDAUDIO_STREAM_FORMAT HDAUDIO_STREAM_FORMAT结构描述捕获或呈现流的数据格式。

枚举

HDAUDIO_CODEC_POWER_STATE HDAUDIO_CODEC_POWER_STATE枚举定义常量，这些常量指定 HD Audio 编解码器可以支持的不同电源状态。 除 PowerCodecD3Cold 外，所有状态均来自 DEVICE_POWER_STATE。
HDAUDIO_STREAM_STATE HDAUDIO_STREAM_STATE枚举定义了指定 HDAudio 支持的不同流状态的常量。