struktur HDAUDIO_BUS_INTERFACE_BDL (hdaudio.h)

Artikel
08/07/2023

Struktur HDAUDIO_BUS_INTERFACE_BDL menentukan informasi yang diperlukan klien untuk memanggil rutinitas dalam versi HDAUDIO_BUS_INTERFACE_BDL DDI Hd Audio. Varian lain dari DDI ini ditentukan oleh struktur HDAUDIO_BUS_INTERFACE .

Sintaks

typedef struct _HDAUDIO_BUS_INTERFACE_BDL {
  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_CONTIGUOUS_DMA_BUFFER AllocateContiguousDmaBuffer;
  PSETUP_DMA_ENGINE_WITH_BDL      SetupDmaEngineWithBdl;
  PFREE_CONTIGUOUS_DMA_BUFFER     FreeContiguousDmaBuffer;
  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;
} HDAUDIO_BUS_INTERFACE_BDL, *PHDAUDIO_BUS_INTERFACE_BDL;

Anggota

Size

Menentukan ukuran dalam byte struktur HDAUDIO_BUS_INTERFACE_BDL.

Version

Menentukan versi DDI Audio HD yang diperluas.

Context

Arahkan ke informasi konteks khusus antarmuka.

InterfaceReference

Penunjuk ke rutinitas yang disediakan driver yang menambah jumlah referensi antarmuka.

InterfaceDereference

Penunjuk ke rutinitas yang disediakan driver yang mengurangi jumlah referensi antarmuka.

TransferCodecVerbs

Penunjuk fungsi ke rutinitas TransferCodecVerbs .

AllocateCaptureDmaEngine

Penunjuk fungsi ke rutinitas AllocateCaptureDmaEngine .

AllocateRenderDmaEngine

Penunjuk fungsi ke rutinitas AllocateRenderDmaEngine .

ChangeBandwidthAllocation

Penunjuk fungsi ke rutinitas ChangeBandwidthAllocation .

AllocateContiguousDmaBuffer

Penunjuk fungsi ke rutinitas AllocateContiguousDmaBuffer .

SetupDmaEngineWithBdl

Penunjuk fungsi ke rutinitas SetupDmaEngineWithBdl .

FreeContiguousDmaBuffer

Penunjuk fungsi ke rutinitas FreeContiguousDmaBuffer .

FreeDmaEngine

Penunjuk fungsi ke rutinitas FreeDmaEngine .

SetDmaEngineState

Penunjuk fungsi ke rutinitas SetDmaEngineState .

GetWallClockRegister

Penunjuk fungsi ke rutinitas GetWallClockRegister .

GetLinkPositionRegister

Penunjuk fungsi ke rutinitas GetLinkPositionRegister .

RegisterEventCallback

Penunjuk fungsi ke rutinitas RegisterEventCallback .

UnregisterEventCallback

Penunjuk fungsi ke rutinitas UnregisterEventCallback .

GetDeviceInformation

Penunjuk fungsi ke rutinitas GetDeviceInformation .

GetResourceInformation

Penunjuk fungsi ke rutinitas GetResourceInformation .

Keterangan

IOCTL IRP_MN_QUERY_INTERFACE menggunakan struktur ini untuk memberikan informasi antarmuka kepada klien yang mengkueri driver bus HD Audio untuk HD Audio DDI. Varian lain dari DDI ini ditentukan oleh struktur HDAUDIO_BUS_INTERFACE.

Struktur HDAUDIO_BUS_INTERFACE_BDL dan HDAUDIO_BUS_INTERFACE serupa tetapi memiliki perbedaan berikut:

HDAUDIO_BUS_INTERFACE_BDL memiliki tiga anggota, AllocateContiguousDmaBuffer, SetupDmaEngineWithBdl, dan FreeContiguousDmaBuffer, yang tidak ada di HDAUDIO_BUS_INTERFACE.
HDAUDIO_BUS_INTERFACE memiliki dua anggota, AllocateDmaBuffer dan FreeDmaBuffer, yang tidak ada di HDAUDIO_BUS_INTERFACE_BDL.

Untuk informasi selengkapnya, lihat Perbedaan Antara Versi HD Audio DDI.

Nama dan definisi lima anggota pertama (Ukuran, Versi, Konteks, InterfaceReference, dan InterfaceDereference) sama seperti dalam struktur ANTARMUKA . Anggota yang tersisa khusus untuk DDI Audio HD yang diperluas dan menentukan penunjuk fungsi ke rutinitas di DDI. Untuk informasi selengkapnya, lihat Mendapatkan Objek DDI HDAUDIO_BUS_INTERFACE_BDL.