structure HDAUDIO_BUS_INTERFACE_V2 (hdaudio.h)

Article
02/07/2025

La structure HDAUDIO_BUS_INTERFACE_V2 spécifie les informations requises par un client pour appeler les routines dans la version HDAUDIO_BUS_INTERFACE_V2 de HD Audio DDI. L’interface représentée par cette structure fournit toutes les fonctionnalités de HDAUDIO_BUS_INTERFACE et peut également prendre en charge la notification d’événement flexible pilotée par DMA.

Syntaxe

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;

Membres

Size

Spécifie la taille, en octets, de la structure HDAUDIO_BUS_INTERFACE_V2.

Version

Spécifie la version de la base de référence HD Audio DDI.

Context

Pointeur vers des informations de contexte spécifiques à l’interface.

InterfaceReference

Pointeur vers une routine fournie par le pilote qui incrémente le nombre de références pour l’interface.

InterfaceDereference

Pointeur vers une routine fournie par le pilote qui décrémente le nombre de références pour l’interface.

TransferCodecVerbs

Pointeur de fonction vers la routine TransferCodecVerbs.

AllocateCaptureDmaEngine

Pointeur de fonction vers la routine AllocateCaptureDmaEngine.

AllocateRenderDmaEngine

Pointeur de fonction vers la routine AllocateRenderDmaEngine.

ChangeBandwidthAllocation

Pointeur de fonction vers la routine ChangeBandwidthAllocation.

AllocateDmaBuffer

Pointeur de fonction vers la routine AllocateDmaBuffer.

FreeDmaBuffer

Pointeur de fonction vers la routine FreeDmaBuffer.

FreeDmaEngine

Pointeur de fonction vers la routine FreeDmaEngine.

SetDmaEngineState

Pointeur de fonction vers la routine SetDmaEngineState.

GetWallClockRegister

Pointeur de fonction vers la routine GetWallClockRegister.

GetLinkPositionRegister

Pointeur de fonction vers la routine GetLinkPositionRegister.

RegisterEventCallback

Pointeur de fonction vers la routine RegisterEventCallback.

UnregisterEventCallback

Pointeur de fonction vers la routine UnregisterEventCallback.

GetDeviceInformation

Pointeur de fonction vers la routine GetDeviceInformation.

GetResourceInformation

Pointeur de fonction vers la routine GetResourceInformation.

AllocateDmaBufferWithNotification

Pointeur de fonction vers la routine AllocateDmaBufferWithNotification.

FreeDmaBufferWithNotification

Pointeur de fonction vers la routine FreeDmaBufferWithNotification.

RegisterNotificationEvent

Pointeur de fonction vers la routine RegisterNotificationEvent.

UnregisterNotificationEvent

Pointeur de fonction vers la routine UnregisterNotificationEvent.

Remarques

La IRP_MN_QUERY_INTERFACE IOCTL utilise cette structure pour fournir des informations sur l’interface à un client qui interroge le pilote de bus HD Audio pour hd audio DDI.

Les noms et définitions des cinq premiers membres de la structure HDAUDIO_BUS_INTERFACE_V2 (Size, Version, Context, InterfaceReference et InterfaceDereference) sont les mêmes que dans la structure INTERFACE. Les membres restants sont spécifiques à la base de référence HD Audio DDI et spécifient des pointeurs de fonction vers les routines dans la DDI.