HDAUDIO_BUS_INTERFACE構造体 (hdaudio.h)

[アーティクル]
08/07/2023

HDAUDIO_BUS_INTERFACE構造体は、クライアントが HD Audio DDI のHDAUDIO_BUS_INTERFACE バージョンでルーチンを呼び出すために必要な情報を指定します。この DDI の別のバリアントは、 HDAUDIO_BUS_INTERFACE_BDL 構造体によって指定されます。

構文

typedef struct _HDAUDIO_BUS_INTERFACE {
  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;
} HDAUDIO_BUS_INTERFACE, *PHDAUDIO_BUS_INTERFACE;

メンバー

Size

HDAUDIO_BUS_INTERFACE構造体のサイズをバイト単位で指定します。

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 ルーチンへの関数ポインター。

注釈

IRP_MN_QUERY_INTERFACE IOCTL は、この構造体を使用して、HD Audio DDI の HD オーディオバスドライバーに対してクエリを実行しているクライアントにインターフェイス情報を提供します。この DDI のもう 1 つのバリアントは、HDAUDIO_BUS_INTERFACE_BDL構造体によって指定されます。

HDAUDIO_BUS_INTERFACEとHDAUDIO_BUS_INTERFACE_BDLの構造体は似ていますが、次のような違いがあります。

HDAUDIO_BUS_INTERFACEには、HDAUDIO_BUS_INTERFACE_BDLに存在しない AllocateDmaBuffer と FreeDmaBuffer の 2 つのメンバーがあります。
HDAUDIO_BUS_INTERFACE_BDLには、 AllocateContiguousDmaBuffer、 FreeContiguousDmaBuffer、 SetupDmaEngineWithBdl の 3 つのメンバーがあり、HDAUDIO_BUS_INTERFACEに存在しません。

詳細については、「 HD オーディオ DDI バージョンの違い」を参照してください。

最初の 5 つのメンバー (Size、 Version、 Context、 InterfaceReference、 InterfaceDereference) の名前と定義は、 INTERFACE 構造体と同じです。残りのメンバーは、ベースライン HD Audio DDI に固有であり、DDI 内のルーチンへの関数ポインターを指定します。詳細については、「 HDAUDIO_BUS_INTERFACE DDI オブジェクトの取得」を参照してください。