HDAUDIO_BUS_INTERFACE-Struktur (hdaudio.h)
Die HDAUDIO_BUS_INTERFACE-Struktur gibt die Informationen an, die ein Client zum Aufrufen der Routinen in der HDAUDIO_BUS_INTERFACE Version von HD Audio DDI benötigt. Eine weitere Variante dieses DDI wird durch die HDAUDIO_BUS_INTERFACE_BDL-Struktur angegeben.
Syntax
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;
Member
Size
Gibt die Größe der HDAUDIO_BUS_INTERFACE-Struktur in Byte an.
Version
Gibt die Version des geplanten HD-Audio-DDI an.
Context
Zeiger auf schnittstellenspezifische Kontextinformationen.
InterfaceReference
Zeiger auf eine vom Treiber bereitgestellte Routine, die die Referenzanzahl der Schnittstelle erhöht.
InterfaceDereference
Zeiger auf eine vom Treiber bereitgestellte Routine, die die Referenzanzahl der Schnittstelle verringert.
TransferCodecVerbs
Funktionszeiger auf die TransferCodecVerbs-Routine .
AllocateCaptureDmaEngine
Funktionszeiger auf die AllocateCaptureDmaEngine-Routine .
AllocateRenderDmaEngine
Funktionszeiger auf die AllocateRenderDmaEngine-Routine .
ChangeBandwidthAllocation
Funktionszeiger auf die ChangeBandwidthAllocation-Routine .
AllocateDmaBuffer
Funktionszeiger auf die AllocateDmaBuffer-Routine .
FreeDmaBuffer
Funktionszeiger auf die FreeDmaBuffer-Routine .
FreeDmaEngine
Funktionszeiger auf die FreeDmaEngine-Routine .
SetDmaEngineState
Funktionszeiger auf die SetDmaEngineState-Routine .
GetWallClockRegister
Funktionszeiger auf die GetWallClockRegister-Routine .
GetLinkPositionRegister
Funktionszeiger auf die GetLinkPositionRegister-Routine .
RegisterEventCallback
Funktionszeiger auf die RegisterEventCallback-Routine .
UnregisterEventCallback
Funktionszeiger auf die UnregisterEventCallback-Routine .
GetDeviceInformation
Funktionszeiger auf die GetDeviceInformation-Routine .
GetResourceInformation
Funktionszeiger auf die GetResourceInformation-Routine .
Hinweise
Die IRP_MN_QUERY_INTERFACE IOCTL verwendet diese Struktur, um Schnittstelleninformationen für einen Client bereitzustellen, der den HD Audio Bus-Treiber für den HD-Audio-DDI fragt. Eine weitere Variante dieses DDI wird durch die HDAUDIO_BUS_INTERFACE_BDL-Struktur angegeben.
Die HDAUDIO_BUS_INTERFACE- und HDAUDIO_BUS_INTERFACE_BDL-Strukturen sind ähnlich, weisen jedoch die folgenden Unterschiede auf:
- HDAUDIO_BUS_INTERFACE verfügt über zwei Member, AllocateDmaBuffer und FreeDmaBuffer, die in HDAUDIO_BUS_INTERFACE_BDL nicht vorhanden sind.
- HDAUDIO_BUS_INTERFACE_BDL verfügt über die drei Member AllocateContiguousDmaBuffer, FreeContiguousDmaBuffer und SetupDmaEngineWithBdl, die in HDAUDIO_BUS_INTERFACE nicht vorhanden sind.
Die Namen und Definitionen der ersten fünf Member (Size, Version, Context, InterfaceReference und InterfaceDereference) sind identisch mit denen in der INTERFACE-Struktur . Die verbleibenden Member sind spezifisch für den baseline HD Audio DDI und geben Funktionszeiger auf die Routinen im DDI an. Weitere Informationen finden Sie unter Abrufen eines HDAUDIO_BUS_INTERFACE DDI-Objekts.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | hdaudio.h (hdaudio.h einschließen) |