struttura HDAUDIO_BUS_INTERFACE_V3 (hdaudio.h)

Articolo
02/07/2025

Sintassi

typedef struct _HDAUDIO_BUS_INTERFACE_V3 {
  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;
  PREGISTER_NOTIFICATION_CALLBACK        RegisterNotificationCallback;
  PUNREGISTER_NOTIFICATION_CALLBACK      UnregisterNotificationCallback;
} HDAUDIO_BUS_INTERFACE_V3, *PHDAUDIO_BUS_INTERFACE_V3;

Membri

Size

Specifica le dimensioni, in byte, della struttura HDAUDIO_BUS_INTERFACE_V3.

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.

RegisterNotificationCallback

Puntatore di funzione alla routine RegisterNotificationCallback.

UnregisterNotificationCallback

Puntatore di funzione alla routine UnregisterNotificationCallback.

Osservazioni

Il IOCTL IRP_MN_QUERY_INTERFACE usa questa struttura per fornire informazioni sull'interfaccia a un client che esegue una 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_V3 (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.

Fabbisogno

Requisito	Valore
client minimo supportato	19H1
intestazione	hdaudio.h (include hdaudio.h)

Vedere anche

IRP_MN_QUERY_INTERFACE IOCTL

hdaudio.h

Condividi tramite