hdaudio.h-Header

Dieser Header wird von Audiodaten verwendet. Weitere Informationen finden Sie unter

• Audio

hdaudio.h enthält die folgenden Programmierschnittstellen:

Rückruffunktionen

PALLOCATE_CAPTURE_DMA_ENGINE Die AllocateCaptureDmaEngine-Routine weist eine DMA-Engine für einen Erfassungsdatenstrom zu. Der Funktionszeigertyp für eine AllocateCaptureDmaEngine-Routine wird wie folgt definiert.
PALLOCATE_CONTIGUOUS_DMA_BUFFER Die AllocateContiguousDmaBuffer-Routine weist einen DMA-Puffer zu, der aus einem einzelnen zusammenhängenden Block physischen Speichers besteht. Der Funktionszeigertyp für eine AllocateContiguousDmaBuffer-Routine ist wie folgt definiert.
PALLOCATE_DMA_BUFFER Die AllocateDmaBuffer-Routine weist einem DMA-Modul einen Datenpuffer im Systemspeicher zu. Der Funktionszeigertyp für eine AllocateDmaBuffer-Routine ist wie folgt definiert.
PALLOCATE_DMA_BUFFER_WITH_NOTIFICATION Die AllocateDmaBufferWithNotification-Routine weist einem DMA-Modul einen Datenpuffer im Systemspeicher zu. Der Funktionszeigertyp für eine AllocateDmaBufferWithNotification-Routine ist wie folgt definiert.
PALLOCATE_RENDER_DMA_ENGINE Die AllocateRenderDmaEngine-Routine ordnet eine DMA-Engine für einen Renderdatenstrom zu. Der Funktionszeigertyp für eine AllocateRenderDmaEngine-Routine wird wie folgt definiert.
PCHANGE_BANDWIDTH_ALLOCATION Die ChangeBandwidthAllocation-Routine ändert die Bandbreitenzuordnung einer DMA-Engine für HD Audio Link. Der Funktionszeigertyp für eine ChangeBandwidthAllocation-Routine wird wie folgt definiert.
PFREE_CONTIGUOUS_DMA_BUFFER Die FreeContiguousDmaBuffer-Routine gibt einen DMA-Puffer und eine Pufferdeskriptorliste (BDL) frei, die durch einen Aufruf von AllocateContiguousDmaBuffer zugeordnet wurden. Der Funktionszeigertyp für eine FreeContiguousDmaBuffer-Routine wird wie folgt definiert.
PFREE_DMA_BUFFER Die FreeDmaBuffer-Routine gibt einen DMA-Puffer frei, der zuvor durch einen Aufruf von AllocateDmaBuffer zugeordnet wurde. Der Funktionszeigertyp für eine FreeDmaBuffer-Routine wird wie folgt definiert.
PFREE_DMA_BUFFER_WITH_NOTIFICATION Die FreeDmaBufferWithNotification-Routine gibt einen DMA-Puffer frei, der zuvor durch einen Aufruf von AllocateDmaBufferWithNotification zugeordnet wurde. Der Funktionszeigertyp für eine FreeDmaBufferWithNotification-Routine wird wie folgt definiert.
PFREE_DMA_ENGINE Die FreeDmaEngine-Routine gibt eine DMA-Engine frei, die zuvor durch einen Aufruf von AllocateCaptureDmaEngine oder AllocateRenderDmaEngine zugeordnet wurde. Der Funktionszeigertyp für eine FreeDmaEngine-Routine wird wie folgt definiert.
PGET_DEVICE_INFORMATION Die GetDeviceInformation-Routine ruft Informationen zum HD-Audiocontrollergerät ab. Der Funktionszeigertyp für eine GetDeviceInformation-Routine wird wie folgt definiert.
PGET_LINK_POSITION_REGISTER Die GetLinkPositionRegister-Routine ruft einen Zeiger auf das Linkpositionsregister einer DMA-Engine ab. Der Funktionszeigertyp für eine GetLinkPositionRegister-Routine ist wie folgt definiert.
PGET_RESOURCE_INFORMATION Die GetResourceInformation-Routine ruft Informationen zu Hardwareressourcen ab. Der Funktionszeigertyp für eine GetResourceInformation-Routine ist wie folgt definiert.
PGET_WALL_CLOCK_REGISTER Die GetWallClockRegister-Routine ruft einen Zeiger auf das Wanduhrregister ab. Der Funktionszeigertyp für eine GetWallClockRegister-Routine ist wie folgt definiert.
PHDAUDIO_BDL_ISR Die HDAudioBdlIsr-Routine ist die ISR, die der HD-Audiobustreiber jedes Mal aufruft, wenn ein IOC-Interrupt im Stream auftritt. Es handelt sich um einen Funktionszeiger vom Typ PHDAUDIO_BDL_ISR, der wie folgt definiert wird.
PHDAUDIO_DMA_NOTIFICATION_CALLBACK HDAudio-Codec DMA-Benachrichtigungsrückruffunktion.
PHDAUDIO_TRANSFER_COMPLETE_CALLBACK HdAudio-Codec-Übertragung vollständige Rückruffunktion. PHDAUDIO_TRANSFER_COMPLETE_CALLBACK wird von der rückruffunktion PTRANSFER_CODEC_VERBS verwendet.
PHDAUDIO_UNSOLICITED_RESPONSE_CALLBACK HDAudio-Codec: Nicht angeforderte Antwortrückruffunktion. PHDAUDIO_UNSOLICITED_RESPONSE_CALLBACK wird von der rückruffunktion PREGISTER_EVENT_CALLBACK verwendet.
PREGISTER_EVENT_CALLBACK Die RegisterEventCallback-Routine registriert eine Rückrufroutine für eine nicht angeforderte Antwort von einem Codec oder Codecs. Der Funktionszeigertyp für eine RegisterEventCallback-Routine ist wie folgt definiert.
PREGISTER_NOTIFICATION_CALLBACK Die RegisterNotificationCallback-Routine registriert eine Rückrufroutine, damit sie DMA-Statusbenachrichtigungen mit genaueren Zeitinformationen empfangen kann.
PREGISTER_NOTIFICATION_EVENT Die RegisterNotificationEvent-Routine registriert ein Kernelereignis, damit es DMA-Statusbenachrichtigungen empfangen kann. Der Funktionszeigertyp für eine RegisterNotificationEvent-Routine ist wie folgt definiert.
PSET_DMA_ENGINE_STATE Die SetDmaEngineState-Routine legt den Status einer oder mehrerer DMA-Engines auf den Status Running, Stopped, Paused oder Reset fest. Der Funktionszeigertyp für eine SetDmaEngineState-Routine ist wie folgt definiert.
PSETUP_DMA_ENGINE_WITH_BDL Die SetupDmaEngineWithBdl-Routine richtet eine DMA-Engine ein, um einen vom Aufrufer zugewiesenen DMA-Puffer zu verwenden. Der Funktionszeigertyp für eine SetupDmaEngineWithBdl-Routine wird wie folgt definiert.
PTRANSFER_CODEC_VERBS Die TransferCodecVerbs-Routine überträgt einen oder mehrere Befehle an einen Codec oder codecs und ruft die Antworten auf diese Befehle ab. Der Funktionszeigertyp für eine TransferCodecVerbs-Routine ist wie folgt definiert.
PUNREGISTER_EVENT_CALLBACK Die UnregisterEventCallback-Routine löscht die Registrierung eines Ereignisrückrufs, der zuvor durch einen Aufruf von RegisterEventCallback registriert wurde. Der Funktionszeigertyp für eine UnregisterEventCallback-Routine ist wie folgt definiert.
PUNREGISTER_NOTIFICATION_CALLBACK Die PUNREGISTER_NOTIFICATION_CALLBACK Rückruffunktion löscht die Registrierung einer Benachrichtigungsrückrufroutine, die zuvor durch einen Aufruf von RegisterNotificationCallback registriert wurde.
PUNREGISTER_NOTIFICATION_EVENT Die UnregisterNotificationEvent-Routine löscht die Registrierung eines Ereignisses, das zuvor durch einen Aufruf von RegisterNotificationEvent registriert wurde. Der Funktionszeigertyp für eine UnregisterNotificationEvent-Routine ist wie folgt definiert.

Strukturen

HDAUDIO_BUFFER_DESCRIPTOR Die HDAUDIO_BUFFER_DESCRIPTOR-Struktur gibt einen Pufferdeskriptor an, bei dem es sich um einen Eintrag in einer Pufferdeskriptorliste (BDL) handelt.
HDAUDIO_BUS_INTERFACE 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.
HDAUDIO_BUS_INTERFACE_BDL Die HDAUDIO_BUS_INTERFACE_BDL-Struktur gibt die Informationen an, die ein Client benötigt, um die Routinen in der HDAUDIO_BUS_INTERFACE_BDL Version von HD Audio DDI aufzurufen. Eine weitere Variante dieses DDI wird durch die HDAUDIO_BUS_INTERFACE-Struktur angegeben.
HDAUDIO_BUS_INTERFACE_V2 Die HDAUDIO_BUS_INTERFACE_V2-Struktur gibt die Informationen an, die ein Client zum Aufrufen der Routinen in der HDAUDIO_BUS_INTERFACE_V2 Version von HD Audio DDI benötigt.
HDAUDIO_BUS_INTERFACE_V3 Weitere Informationen: _HDAUDIO_BUS_INTERFACE_V3-Struktur
HDAUDIO_CODEC_COMMAND Die HDAUDIO_CODEC_COMMAND-Struktur gibt einen Codecbefehl an.
HDAUDIO_CODEC_RESPONSE Die HDAUDIO_CODEC_RESPONSE-Struktur gibt entweder eine Antwort auf einen Codecbefehl oder eine nicht angeforderte Antwort von einem Codec an.
HDAUDIO_CODEC_TRANSFER Die HDAUDIO_CODEC_TRANSFER-Struktur gibt einen Codecbefehl und die Antwort auf diesen Befehl an.
HDAUDIO_CONVERTER_FORMAT Die HDAUDIO_CONVERTER_FORMAT-Struktur gibt das 16-Bit-codierte Streamformat für einen Eingabe- oder Ausgabekonverter an, wie in der Intel High Definition Audio Specification definiert (siehe Intel HD Audio-Website).
HDAUDIO_DEVICE_INFORMATION Die HDAUDIO_DEVICE_INFORMATION-Struktur gibt die Hardwarefunktionen des HD-Audiobuscontrollers an.
HDAUDIO_DEVICE_INFORMATION_V2 Die HDAUDIO_DEVICE_INFORMATION_V2-Struktur gibt die Hardwarefunktionen des HD-Audiobuscontrollers an.
HDAUDIO_STREAM_FORMAT Die HDAUDIO_STREAM_FORMAT-Struktur beschreibt das Datenformat eines Aufzeichnungs- oder Renderdatenstroms.

Enumerationen

HDAUDIO_CODEC_POWER_STATE Die HDAUDIO_CODEC_POWER_STATE-Enumeration definiert Konstanten, die die verschiedenen Leistungszustände angeben, die HD-Audiocodecs unterstützen können. Alle Zustände stammen aus DEVICE_POWER_STATE mit Ausnahme von PowerCodecD3Cold.
HDAUDIO_STREAM_STATE Die HDAUDIO_STREAM_STATE-Enumeration definiert Konstanten, die die verschiedenen Streamzustände angeben, die von HDAudio unterstützt werden.