HDAUDIO_BUS_INTERFACE_V2 Struktur (hdaudio.h)

Artikel
02/26/2024

Die HDAUDIO_BUS_INTERFACE_V2-Struktur gibt die Informationen an, die ein Client zum Aufrufen der Routinen in der HDAUDIO_BUS_INTERFACE_V2 Version des HD Audio DDI benötigt. Die von dieser Struktur dargestellte Schnittstelle bietet alle Funktionen von HDAUDIO_BUS_INTERFACE und kann auch flexible DMA-gesteuerte Ereignisbenachrichtigungen unterstützen.

Syntax

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;

Member

Size

Gibt die Größe der HDAUDIO_BUS_INTERFACE_V2-Struktur in Bytes an.

Version

Gibt die Version des HD-Audio-Baseline-DDI an.

Context

Ein Zeiger auf schnittstellenspezifische Kontextinformationen.

InterfaceReference

Ein Zeiger auf eine vom Treiber bereitgestellte Routine, die die Verweisanzahl für die Schnittstelle erhöht.

InterfaceDereference

Ein Zeiger auf eine vom Treiber bereitgestellte Routine, die die Verweisanzahl für die Schnittstelle dekrementiert.

TransferCodecVerbs

Ein Funktionszeiger auf die TransferCodecVerbs-Routine .

AllocateCaptureDmaEngine

Ein Funktionszeiger auf die AllocateCaptureDmaEngine-Routine .

AllocateRenderDmaEngine

Ein Funktionszeiger auf die AllocateRenderDmaEngine-Routine .

ChangeBandwidthAllocation

Ein Funktionszeiger auf die ChangeBandwidthAllocation-Routine .

AllocateDmaBuffer

Ein Funktionszeiger auf die AllocateDmaBuffer-Routine .

FreeDmaBuffer

Ein Funktionszeiger auf die FreeDmaBuffer-Routine .

FreeDmaEngine

Ein Funktionszeiger auf die FreeDmaEngine-Routine .

SetDmaEngineState

Ein Funktionszeiger auf die SetDmaEngineState-Routine .

GetWallClockRegister

Ein Funktionszeiger auf die GetWallClockRegister-Routine .

GetLinkPositionRegister

Ein Funktionszeiger auf die GetLinkPositionRegister-Routine .

RegisterEventCallback

Ein Funktionszeiger auf die RegisterEventCallback-Routine .

UnregisterEventCallback

Ein Funktionszeiger auf die UnregisterEventCallback-Routine .

GetDeviceInformation

Ein Funktionszeiger auf die GetDeviceInformation-Routine .

GetResourceInformation

Ein Funktionszeiger auf die GetResourceInformation-Routine .

AllocateDmaBufferWithNotification

Ein Funktionszeiger auf die AllocateDmaBufferWithNotification-Routine .

FreeDmaBufferWithNotification

Ein Funktionszeiger auf die FreeDmaBufferWithNotification-Routine .

RegisterNotificationEvent

Ein Funktionszeiger auf die RegisterNotificationEvent-Routine .

UnregisterNotificationEvent

Ein Funktionszeiger auf die UnregisterNotificationEvent-Routine .

Hinweise

Die IRP_MN_QUERY_INTERFACE IOCTL verwendet diese Struktur, um Schnittstelleninformationen für einen Client bereitzustellen, der den HD Audio-Bustreiber für den HD Audio DDI abfragt.

Die Namen und Definitionen der ersten fünf Member der HDAUDIO_BUS_INTERFACE_V2-Struktur (Size, Version, Context, InterfaceReference und InterfaceDereference) sind identisch mit denen in der INTERFACE-Struktur . Die restlichen Member sind spezifisch für den HD Audio-Baseline-DDI und geben Funktionszeiger auf die Routinen im DDI an.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und späteren Windows-Versionen.
Kopfzeile	hdaudio.h (einschließlich Hdaudio.h)