HDAUDIO_BUS_INTERFACE_V2 結構 (hdaudio.h)

發行項
02/27/2024

HDAUDIO_BUS_INTERFACE_V2 結構會指定用戶端在 HD 音訊 DDI HDAUDIO_BUS_INTERFACE_V2 版本中呼叫例程所需的資訊。此結構所代表的介面提供 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 音訊 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 音訊 DDI 之 HD 音訊總線驅動程式的用戶端。

HDAUDIO_BUS_INTERFACE_V2結構前五個成員的名稱和定義 (Size、Version、Context、InterfaceReference 和 InterfaceDereference) 與 INTERFACE 結構相同。其餘成員是基準 HD 音訊 DDI 特有的，並指定 DDI 中例程的函式指標。