estrutura HDAUDIO_BUS_INTERFACE_V2 (hdaudio.h)

Artigo
08/07/2023

A estrutura HDAUDIO_BUS_INTERFACE_V2 especifica as informações que um cliente precisa para chamar as rotinas na versão HDAUDIO_BUS_INTERFACE_V2 da DDI de áudio HD. A interface representada por essa estrutura fornece toda a funcionalidade de HDAUDIO_BUS_INTERFACE e também pode dar suporte à notificação de evento flexível controlada por DMA.

Sintaxe

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;

Membros

Size

Especifica o tamanho, em bytes, da estrutura HDAUDIO_BUS_INTERFACE_V2.

Version

Especifica a versão da DDI de áudio HD da linha de base.

Context

Um ponteiro para informações de contexto específicas da interface.

InterfaceReference

Um ponteiro para uma rotina fornecida pelo driver que incrementa a contagem de referência para a interface.

InterfaceDereference

Um ponteiro para uma rotina fornecida pelo driver que diminui a contagem de referência para a interface.

TransferCodecVerbs

Um ponteiro de função para a rotina TransferCodecVerbs .

AllocateCaptureDmaEngine

Um ponteiro de função para a rotina AllocateCaptureDmaEngine .

AllocateRenderDmaEngine

Um ponteiro de função para a rotina AllocateRenderDmaEngine .

ChangeBandwidthAllocation

Um ponteiro de função para a rotina ChangeBandwidthAllocation .

AllocateDmaBuffer

Um ponteiro de função para a rotina AllocateDmaBuffer .

FreeDmaBuffer

Um ponteiro de função para a rotina FreeDmaBuffer .

FreeDmaEngine

Um ponteiro de função para a rotina FreeDmaEngine .

SetDmaEngineState

Um ponteiro de função para a rotina SetDmaEngineState .

GetWallClockRegister

Um ponteiro de função para a rotina GetWallClockRegister .

GetLinkPositionRegister

Um ponteiro de função para a rotina GetLinkPositionRegister .

RegisterEventCallback

Um ponteiro de função para a rotina RegisterEventCallback .

UnregisterEventCallback

Um ponteiro de função para a rotina UnregisterEventCallback .

GetDeviceInformation

Um ponteiro de função para a rotina GetDeviceInformation .

GetResourceInformation

Um ponteiro de função para a rotina GetResourceInformation .

AllocateDmaBufferWithNotification

Um ponteiro de função para a rotina AllocateDmaBufferWithNotification .

FreeDmaBufferWithNotification

Um ponteiro de função para a rotina FreeDmaBufferWithNotification .

RegisterNotificationEvent

Um ponteiro de função para a rotina RegisterNotificationEvent .

UnregisterNotificationEvent

Um ponteiro de função para a rotina UnregisterNotificationEvent .

Comentários

O IRP_MN_QUERY_INTERFACE IOCTL usa essa estrutura para fornecer informações de interface a um cliente que está consultando o driver do barramento de áudio HD para a DDI de áudio HD.

Os nomes e definições dos cinco primeiros membros da estrutura de HDAUDIO_BUS_INTERFACE_V2 (Size, Version, Context, InterfaceReference e InterfaceDereference) são os mesmos da estrutura interface . Os membros restantes são específicos para a DDI de áudio HD da linha de base e especificam ponteiros de função para as rotinas na DDI.