struktur HDAUDIO_BUS_INTERFACE (hdaudio.h)

Artikel
08/07/2023

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

Sintaks

typedef struct _HDAUDIO_BUS_INTERFACE {
  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;
} HDAUDIO_BUS_INTERFACE, *PHDAUDIO_BUS_INTERFACE;

Anggota

Size

Menentukan ukuran dalam byte struktur HDAUDIO_BUS_INTERFACE.

Version

Menentukan versi garis besar HD Audio DDI.

Context

Arahkan ke informasi konteks khusus antarmuka.

InterfaceReference

Penunjuk ke rutinitas yang disediakan driver yang menaikkan 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 .

AllocateDmaBuffer

Penunjuk fungsi ke rutinitas AllocateDmaBuffer .

FreeDmaBuffer

Penunjuk fungsi ke rutinitas FreeDmaBuffer .

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

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

Struktur HDAUDIO_BUS_INTERFACE dan HDAUDIO_BUS_INTERFACE_BDL serupa tetapi memiliki perbedaan berikut:

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

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 garis besar dan menentukan penunjuk fungsi ke rutinitas di DDI. Untuk informasi selengkapnya, lihat Mendapatkan Objek DDI HDAUDIO_BUS_INTERFACE.