HDAUDIO_BUS_INTERFACE_V2 struttura (hdaudio.h)

Articolo
08/07/2023

La struttura HDAUDIO_BUS_INTERFACE_V2 specifica le informazioni necessarie per chiamare le routine nella versione HDAUDIO_BUS_INTERFACE_V2 di HD Audio DDI. L'interfaccia rappresentata da questa struttura offre tutte le funzionalità di HDAUDIO_BUS_INTERFACE e può supportare anche una notifica evento 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;

Members

Size

Specifica le dimensioni, in byte, della struttura HDAUDIO_BUS_INTERFACE_V2.

Version

Specifica la versione dell'audio DDI HD di base.

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 decreta 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 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 alla routine RegisterEventCallback .

UnregisterEventCallback

Puntatore di funzione alla routine UnregisterEventCallback .

GetDeviceInformation

Puntatore di funzione alla routine GetDeviceInformation .

GetResourceInformation

Puntatore alla routine GetResourceInformation .

AllocateDmaBufferWithNotification

Puntatore alla routine AllocateDmaBufferWithNotification .

FreeDmaBufferWithNotification

Puntatore di funzione alla routine FreeDmaBufferWithNotification .

RegisterNotificationEvent

Puntatore alla routine RegisterNotificationEvent .

UnregisterNotificationEvent

Puntatore alla routine UnregisterNotificationEvent .

Commenti

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

I nomi e le definizioni dei primi cinque membri della struttura HDAUDIO_BUS_INTERFACE_V2 (Size, Version, Context, InterfaceReference e InterfaceDereference) sono uguali alla struttura INTERFACE . I membri rimanenti sono specifici dell'DDI audio HD di base e specificano i puntatori di funzione alle routine nell'DDI.