estructura HDAUDIO_BUS_INTERFACE_V2 (hdaudio.h)
La estructura HDAUDIO_BUS_INTERFACE_V2 especifica la información que un cliente necesita para llamar a las rutinas en la versión HDAUDIO_BUS_INTERFACE_V2 de la DDI de audio HD. La interfaz representada por esta estructura proporciona toda la funcionalidad de HDAUDIO_BUS_INTERFACE y también puede admitir notificaciones de eventos controladas por DMA flexibles.
Sintaxis
typedef struct _HDAUDIO_BUS_INTERFACE_V2 {
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;
PALLOCATE_DMA_BUFFER_WITH_NOTIFICATION AllocateDmaBufferWithNotification;
PFREE_DMA_BUFFER_WITH_NOTIFICATION FreeDmaBufferWithNotification;
PREGISTER_NOTIFICATION_EVENT RegisterNotificationEvent;
PUNREGISTER_NOTIFICATION_EVENT UnregisterNotificationEvent;
} HDAUDIO_BUS_INTERFACE_V2, *PHDAUDIO_BUS_INTERFACE_V2;
Miembros
Size
Especifica el tamaño, en bytes, de la estructura HDAUDIO_BUS_INTERFACE_V2.
Version
Especifica la versión de la DDI de audio HD de línea base.
Context
Puntero a información de contexto específica de la interfaz.
InterfaceReference
Puntero a una rutina proporcionada por el controlador que incrementa el recuento de referencias de la interfaz.
InterfaceDereference
Puntero a una rutina proporcionada por el controlador que disminuye el recuento de referencias de la interfaz.
TransferCodecVerbs
Puntero de función a la rutina TransferCodecVerbs.
AllocateCaptureDmaEngine
Puntero de función a la rutina de AllocateCaptureDmaEngine.
AllocateRenderDmaEngine
Puntero de función a la rutina de AllocateRenderDmaEngine.
ChangeBandwidthAllocation
Puntero de función a la rutina ChangeBandwidthAllocation.
AllocateDmaBuffer
Puntero de función a la rutina de AllocateDmaBuffer.
FreeDmaBuffer
Puntero de función a la rutina FreeDmaBuffer.
FreeDmaEngine
Puntero de función a la rutina FreeDmaEngine.
SetDmaEngineState
Puntero de función a la rutina setDmaEngineState de.
GetWallClockRegister
Puntero de función a la rutina de GetWallClockRegister.
GetLinkPositionRegister
Puntero de función a la rutina de GetLinkPositionRegister.
RegisterEventCallback
Puntero de función a la rutina RegisterEventCallback.
UnregisterEventCallback
Puntero de función a la rutina UnregisterEventCallback.
GetDeviceInformation
Puntero de función a la rutina GetDeviceInformation.
GetResourceInformation
Puntero de función a la rutina GetResourceInformation.
AllocateDmaBufferWithNotification
Puntero de función a la rutina de AllocateDmaBufferWithNotification.
FreeDmaBufferWithNotification
Puntero de función a la rutina FreeDmaBufferWithNotification.
RegisterNotificationEvent
Puntero de función a la rutina de RegisterNotificationEvent.
UnregisterNotificationEvent
Puntero de función a la rutina UnregisterNotificationEvent.
Observaciones
El IRP_MN_QUERY_INTERFACE IOCTL usa esta estructura para proporcionar información de interfaz a un cliente que consulta el controlador de bus de AUDIO HD para el DDI de audio HD.
Los nombres y definiciones de los cinco primeros miembros de la estructura HDAUDIO_BUS_INTERFACE_V2 (Size, Version, Context, InterfaceReference y InterfaceDereference) son los mismos que en la estructura INTERFACE de. Los miembros restantes son específicos de la base de referencia HD Audio DDI y especifican punteros de función a las rutinas de DDI.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de Windows. |
| encabezado de | hdaudio.h (incluya Hdaudio.h) |