HDAUDIO_BUS_INTERFACE Struktur (hdaudio.h)

2025-02-07

Die HDAUDIO_BUS_INTERFACE-Struktur gibt die Informationen an, die ein Client zum Aufrufen der Routinen in der HDAUDIO_BUS_INTERFACE Version von HD Audio DDI benötigt. Eine weitere Variante dieses DDI wird durch die HDAUDIO_BUS_INTERFACE_BDL Struktur angegeben.

Syntax

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;

Angehörige

Size

Gibt die Größe in Byte der HDAUDIO_BUS_INTERFACE Struktur an.

Version

Gibt die Version der geplanten HD-Audio-DDI an.

Context

Zeiger auf schnittstellenspezifische Kontextinformationen.

InterfaceReference

Zeiger auf eine vom Treiber bereitgestellte Routine, die die Referenzanzahl der Schnittstelle erhöht.

InterfaceDereference

Zeiger auf eine vom Treiber bereitgestellte Routine, die die Referenzanzahl der Schnittstelle verringert.

TransferCodecVerbs

Funktionszeiger auf die TransferCodecVerbs Routine.

AllocateCaptureDmaEngine

Funktionszeiger auf die AllocateCaptureDmaEngine Routine.

AllocateRenderDmaEngine

Funktionszeiger auf die AllocateRenderDmaEngine Routine.

ChangeBandwidthAllocation

Funktionszeiger auf die ChangeBandwidthAllocation Routine.

AllocateDmaBuffer

Funktionszeiger auf die AllocateDmaBuffer Routine.

FreeDmaBuffer

Funktionszeiger auf die FreeDmaBuffer Routine.

FreeDmaEngine

Funktionszeiger auf die FreeDmaEngine Routine.

SetDmaEngineState

Funktionszeiger auf die SetDmaEngineState Routine.

GetWallClockRegister

Funktionszeiger auf die GetWallClockRegister Routine.

GetLinkPositionRegister

Funktionszeiger auf die GetLinkPositionRegister Routine.

RegisterEventCallback

Funktionszeiger auf die RegisterEventCallback Routine.

UnregisterEventCallback

Funktionszeiger auf die UnregisterEventCallback Routine.

GetDeviceInformation

Funktionszeiger auf die GetDeviceInformation Routine.

GetResourceInformation

Funktionszeiger auf die GetResourceInformation Routine.

Bemerkungen

Die IRP_MN_QUERY_INTERFACE IOCTL verwendet diese Struktur, um Schnittstelleninformationen für einen Client bereitzustellen, der den HD-Audiobustreiber für den HD Audio DDI abfragt. Eine weitere Variante dieses DDI wird durch die HDAUDIO_BUS_INTERFACE_BDL-Struktur angegeben.

Die strukturen HDAUDIO_BUS_INTERFACE und HDAUDIO_BUS_INTERFACE_BDL sind ähnlich, weisen jedoch die folgenden Unterschiede auf:

HDAUDIO_BUS_INTERFACE hat zwei Mitglieder, AllocateDmaBuffer und FreeDmaBuffer, die nicht in HDAUDIO_BUS_INTERFACE_BDL vorhanden sind.
HDAUDIO_BUS_INTERFACE_BDL verfügt über drei Mitglieder, AllocateContiguousDmaBuffer, FreeContiguousDmaBufferund SetupDmaEngineWithBdl, die nicht in HDAUDIO_BUS_INTERFACE vorhanden sind.

Weitere Informationen finden Sie unter Unterschiede zwischen den HD Audio DDI-Versionen.

Die Namen und Definitionen der ersten fünf Member (Size, Version, Context, InterfaceReferenceund InterfaceDereference) sind identisch mit der INTERFACE Struktur. Die verbleibenden Member sind spezifisch für die baseline HD Audio DDI und geben Funktionszeiger auf die Routinen in der DDI an. Weitere Informationen finden Sie unter Abrufen eines HDAUDIO_BUS_INTERFACE DDI-Objekts.