HDAUDIO_BUS_INTERFACE 구조체(hdaudio.h)

아티클
08/07/2023

HDAUDIO_BUS_INTERFACE 구조는 클라이언트가 HD 오디오 DDI의 HDAUDIO_BUS_INTERFACE 버전에서 루틴을 호출하는 데 필요한 정보를 지정합니다. 이 DDI의 또 다른 변형은 HDAUDIO_BUS_INTERFACE_BDL 구조체에 의해 지정됩니다.

구문

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;

멤버

Size

HDAUDIO_BUS_INTERFACE 구조체의 크기(바이트)를 지정합니다.

Version

기준 HD Audio DDI의 버전을 지정합니다.

Context

인터페이스별 컨텍스트 정보에 대한 포인터입니다.

InterfaceReference

인터페이스의 참조 수를 증가시키는 드라이버 제공 루틴에 대한 포인터입니다.

InterfaceDereference

인터페이스의 참조 수를 감소시키는 드라이버 제공 루틴에 대한 포인터입니다.

TransferCodecVerbs

TransferCodecVerbs 루틴에 대한 함수 포인터입니다.

AllocateCaptureDmaEngine

AllocateCaptureDmaEngine 루틴에 대한 함수 포인터입니다.

AllocateRenderDmaEngine

AllocateRenderDmaEngine 루틴에 대한 함수 포인터입니다.

ChangeBandwidthAllocation

ChangeBandwidthAllocation 루틴에 대한 함수 포인터입니다.

AllocateDmaBuffer

AllocateDmaBuffer 루틴에 대한 함수 포인터입니다.

FreeDmaBuffer

FreeDmaBuffer 루틴에 대한 함수 포인터입니다.

FreeDmaEngine

FreeDmaEngine 루틴에 대한 함수 포인터입니다.

SetDmaEngineState

SetDmaEngineState 루틴에 대한 함수 포인터입니다.

GetWallClockRegister

GetWallClockRegister 루틴에 대한 함수 포인터입니다.

GetLinkPositionRegister

GetLinkPositionRegister 루틴에 대한 함수 포인터입니다.

RegisterEventCallback

RegisterEventCallback 루틴에 대한 함수 포인터입니다.

UnregisterEventCallback

UnregisterEventCallback 루틴에 대한 함수 포인터입니다.

GetDeviceInformation

GetDeviceInformation 루틴에 대한 함수 포인터입니다.

GetResourceInformation

GetResourceInformation 루틴에 대한 함수 포인터입니다.

설명

IRP_MN_QUERY_INTERFACE IOCTL은 이 구조를 사용하여 HD Audio DDI에 대한 HD 오디오 버스 드라이버를 쿼리하는 클라이언트에 인터페이스 정보를 제공합니다. 이 DDI의 또 다른 변형은 HDAUDIO_BUS_INTERFACE_BDL 구조체에 의해 지정됩니다.

HDAUDIO_BUS_INTERFACE 및 HDAUDIO_BUS_INTERFACE_BDL 구조는 비슷하지만 다음과 같은 차이점이 있습니다.

HDAUDIO_BUS_INTERFACE HDAUDIO_BUS_INTERFACE_BDL 없는 두 멤버인 AllocateDmaBuffer 와 FreeDmaBuffer가 있습니다.
HDAUDIO_BUS_INTERFACE_BDL HDAUDIO_BUS_INTERFACE 없는 세 개의 멤버인 AllocateContiguousDmaBuffer, FreeContiguousDmaBuffer 및 SetupDmaEngineWithBdl이 있습니다.

자세한 내용은 HD 오디오 DDI 버전 간의 차이점을 참조하세요.

처음 5개 멤버(크기, 버전, 컨텍스트, InterfaceReference 및 InterfaceDereference)의 이름과 정의는 INTERFACE 구조와 동일합니다. 나머지 멤버는 기준 HD 오디오 DDI와 관련이 있으며 DDI의 루틴에 대한 함수 포인터를 지정합니다. 자세한 내용은 HDAUDIO_BUS_INTERFACE DDI 개체 가져오기를 참조하세요.