struttura HDAUDIO_BUS_INTERFACE_V2 (hdaudio.h)

2025-04-09

La struttura HDAUDIO_BUS_INTERFACE_V2 specifica le informazioni richieste da un client per chiamare le routine nella versione HDAUDIO_BUS_INTERFACE_V2 di HD Audio DDI. L'interfaccia rappresentata da questa struttura fornisce tutte le funzionalità di HDAUDIO_BUS_INTERFACE e può supportare anche la notifica degli eventi basata su DMA flessibile.

Sintassi

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;

Membri

Size

Specifica le dimensioni, in byte, della struttura HDAUDIO_BUS_INTERFACE_V2.

Version

Specifica la versione di base di HD Audio DDI.

Context

Puntatore a informazioni di contesto specifiche dell'interfaccia.

InterfaceReference

Puntatore a una routine fornita dal driver che incrementa il conteggio dei riferimenti per l'interfaccia.

InterfaceDereference

Puntatore a una routine fornita dal driver che decrementa il conteggio dei riferimenti per l'interfaccia.

TransferCodecVerbs

Puntatore di funzione alla routine TransferCodecVerbs .

AllocateCaptureDmaEngine

Puntatore di funzione alla routine AllocateCaptureDmaEngine .

AllocateRenderDmaEngine

Puntatore di funzione alla routine AllocateRenderDmaEngine .

ChangeBandwidthAllocation

Puntatore di funzione alla routine ChangeBandwidthAllocation .

AllocateDmaBuffer

Puntatore di funzione alla routine AllocateDmaBuffer .

FreeDmaBuffer

Puntatore di funzione alla routine FreeDmaBuffer .

FreeDmaEngine

Puntatore di funzione alla routine FreeDmaEngine .

SetDmaEngineState

Puntatore di funzione alla routine SetDmaEngineState .

GetWallClockRegister

Puntatore di funzione alla routine GetWallClockRegister .

GetLinkPositionRegister

Puntatore di funzione alla routine GetLinkPositionRegister .

RegisterEventCallback

Puntatore di funzione alla routine RegisterEventCallback .

UnregisterEventCallback

Puntatore di funzione alla routine UnregisterEventCallback .

GetDeviceInformation

Puntatore a funzione alla routine GetDeviceInformation .

GetResourceInformation

Puntatore di funzione alla routine GetResourceInformation .

AllocateDmaBufferWithNotification

Puntatore di funzione alla routine AllocateDmaBufferWithNotification .

FreeDmaBufferWithNotification

Puntatore di funzione alla routine FreeDmaBufferWithNotification .

RegisterNotificationEvent

Puntatore di funzione alla routine RegisterNotificationEvent .

UnregisterNotificationEvent

Puntatore di funzione alla routine UnregisterNotificationEvent .

Osservazioni:

Il IRP_MN_QUERY_INTERFACE IOCTL usa questa struttura per fornire informazioni sull'interfaccia a un client che esegue query sul driver del bus audio HD per l'HD Audio DDI.

I nomi e le definizioni dei primi cinque membri della struttura HDAUDIO_BUS_INTERFACE_V2 (Size, Version, Context, InterfaceReference e InterfaceDereference) sono gli stessi della struttura INTERFACE . I membri rimanenti sono specifici della baseline HD Audio DDI e specificano puntatori di funzione alle routine nell'DDI.