Referencia de DDI de dispositivos de audio

Información general sobre la tecnología de referencia de DDI de dispositivos de audio.

Para desarrollar la referencia de DDI de dispositivos de audio, necesita estos encabezados:

Para obtener instrucciones de programación para esta tecnología, consulte:

Enumeraciones

 
APO_FLAG

La enumeración APO_FLAG define constantes que un objeto de procesamiento de audio (APO) usa como marcas.
APO_LOG_LEVEL

Especifica el nivel de un evento de APO registrado con IAudioProcessingObjectLoggingService::ApoLog.
APO_NOTIFICATION_TYPE

Especifica el tipo de un APO_NOTIFICATION.
AUDIO_SYSTEMEFFECT_STATE

Especifica el estado de un efecto de audio objeto de procesamiento de audio (sAPO) de efectos del sistema.
KSPROPERTY_AUDIOEFFECTSDISCOVERY

La enumeración KSPROPERTY_AUDIOEFFECTSDISCOVERY define una constante que usa la lista de objetos de procesamiento de audio (API).

Functions

 
AcceptInput

Proporciona entrada al APO en una de sus entradas auxiliares.
Activar

El método Activate habilita o deshabilita el dispositivo de audio bajo control de programa.
Activar

El método Activate activa o desactiva el receptor del sintetizador.
AddAuxiliaryInput

Agrega una entrada auxiliar al APO y proporciona parámetros de inicialización.
AERT_Allocate

La función de utilidad AERT_Allocate asigna y bloquea un segmento de memoria para su uso por parte de objetos de procesamiento de audio.
AERT_Free

La función de utilidad AERT_Free libera (libera) memoria bloqueada por la función AERT_Allocate, para usarla por los objetos de procesamiento de audio para procesar datos de audio.
ApoLog

Registra un evento de APO.
APOProcess

El método APOProcess hace que el APO realice un paso de procesamiento.
AssignChannelToBuses

AssignChannelToBuses no es compatible y puede modificarse o no estar disponible en el futuro.
CalcInputFrames

El método CalcInputFrames devuelve el número de fotogramas de entrada que requiere un APO para generar un número determinado de fotogramas de salida.
CalcOutputFrames

El método CalcOutputFrames devuelve el número de fotogramas de salida que requiere un APO para un número determinado de fotogramas de entrada.
Cerrar

El método Close cierra un "puerto" de DirectMusic, que es un término de DirectMusic para un dispositivo que envía o recibe datos de música.
Confirmar

Una vez realizado un cambio, este método guarda los cambios.
CreateAudioMediaType

La función CreateAudioMediaType usa el formato especificado por el autor de la llamada para crear un objeto de tipo multimedia que describa el formato de audio.
CreateAudioMediaTypeFromUncompressedAudioFormat

La función CreateAudioMediaTypeFromUncompressedAudioFormat usa la información proporcionada en la estructura UNCOMPRESSEDAUDIOFORMAT para crear un objeto de tipo multimedia que describa el formato de audio.
Descargar

El método Download descarga una definición de onda o instrumento en el sintetizador.
GetApoNotificationRegistrationInfo

Llamado por el sistema para permitir que los clientes se registren para recibir devoluciones de llamada de notificación para el punto de conexión de APO y las notificaciones de efecto del sistema.
GetAppend

El método GetAppend genera el número de muestras de onda adicionales que el "puerto" directMusic debe haber anexado al final de un búfer de descarga.
GetAt

Obtiene una clave de propiedad de la matriz de propiedades de un elemento.
GetAudioFormat

El método GetAudioFormat devuelve la estructura WAVEFORMATEX para el formato de datos de audio.
GetChannelPriority

El método GetChannelPriority genera la prioridad de un canal MIDI.
GetControllableSystemEffectsList

Implementado por efectos del sistema Objeto de procesamiento de audio (sAPO) efectos de audio para permitir al autor de la llamada obtener la lista actual de efectos.
GetCount

Este método devuelve un recuento del número de propiedades adjuntas al archivo.
GetDesiredBufferSize

El método GetDesiredBufferSize recupera el tamaño de búfer preferido del sintetizador, expresado en muestras.
GetEffectsList

El método GetEffectsList se usa para recuperar la lista de efectos de procesamiento de audio que están activos actualmente y almacena un evento que se indicará si cambia la lista.
GetFormat

El método GetFormat recupera una representación IAudioMediaType de un formato personalizado.
GetFormat

El método GetFormat recupera información sobre el formato de onda.
GetFormatCount

El método GetFormatCount recupera el número de formatos personalizados admitidos por el objeto de procesamiento de audio (sAPO) de efectos del sistema.
GetFormatRepresentation

El método GetFormatRepresentation recupera una representación de cadena del formato personalizado para que se pueda mostrar en una interfaz de usuario.
GetInputChannelCount

GetInputChannelCount devuelve el recuento de canales de entrada (ejemplos por fotograma) para este APO.
GetLatency

El método GetLatency devuelve la latencia de este APO. La latencia es la cantidad de tiempo que tarda un fotograma en recorrer el paso de procesamiento de un APO.
GetLatencyClock

El método GetLatencyClock recupera una referencia a la interfaz IReferenceClock (descrita en la documentación Microsoft Windows SDK) del objeto de reloj de referencia que realiza un seguimiento del tiempo de combinación actual.
GetLatencyClock

El método GetLatencyClock recupera el reloj de latencia, que mide el progreso de la secuencia de audio de salida.
GetPortCaps

El método GetPortCaps recupera las funciones de un "puerto" de DirectMusic, que es un término de DirectMusic para un dispositivo que envía o recibe datos de música.
GetRealTimeWorkQueue

Obtiene el identificador de una cola de trabajo que el APO puede usar para programar tareas que deben ejecutarse en una prioridad en tiempo real.
GetRegistrationProperties

GetRegistrationProperties devuelve las propiedades de registro del objeto de procesamiento de audio (APO).
GetRunningStats

El método GetRunningStats recupera información actual sobre el estado del sintetizador para que una aplicación pueda saber cómo funciona el sintetizador.
GetUncompressedAudioFormat

IAudioMediaType::GetUncompressedAudioFormat devuelve información sobre el formato de datos de audio.
GetValue

Este método recupera los datos de una propiedad específica.
GetVoiceState

GetVoiceState no es compatible y puede modificarse o no estar disponible en el futuro.
HandleNotification

Llamado por el sistema para notificar a los clientes los cambios en los puntos de conexión de APO o los efectos del sistema.
Init

El método Init inicializa el objeto synth-sink.
Inicialización

El método Initialize inicializa el APO y admite datos de longitud variable.
IsCompressedFormat

El método IsCompressedFormat determina si el formato de datos de audio es un formato comprimido.
IsEqual

El método IsEqual compara dos tipos de medios y determina si son idénticos.
IsInputFormatSupported

Comprueba que el APO admite un formato de entrada auxiliar específico.
IsInputFormatSupported

Este método negocia con el motor de audio de Windows Vista para establecer un formato de datos para la secuencia de datos de audio.
IsOutputFormatSupported

El método IsOutputFormatSupported se usa para comprobar que se admite un formato de salida específico.
LockForProcess

El método LockForProcess se usa para comprobar que el APO está bloqueado y listo para procesar los datos.
Abrir

El método Open abre un sintetizador de DirectMusic "port".
PlayBuffer

El método PlayBuffer descarga una secuencia de mensajes MIDI en el sintetizador.
PlayVoice

PlayVoice no es compatible y puede modificarse o no estar disponible en el futuro.
Actualizar

La actualización no es compatible y puede modificarse o no estar disponible en el futuro.
RefTimeToSample

El método RefTimeToSample convierte una hora de referencia en una hora de ejemplo.
RemoveAuxiliaryInput

Quita una entrada auxiliar del APO.
Representar

El receptor de synth llama al método Render para representarlo en un búfer de la secuencia de audio.
Reset

El método Reset restablece el APO a su estado original. Este método no provoca ningún cambio en los objetos de conexión que están conectados a la entrada o a la salida del APO.
SampleToRefTime

El método SampleToRefTime convierte una hora de ejemplo en una hora de referencia.
SetAudioDeviceModulesManager

Lo llama el sistema para pasar una instancia de IAudioDeviceModulesManager a objetos de procesamiento de audio (API) que implementan la interfaz IAudioDeviceModulesClient .
SetAudioSystemEffectState

Implementado por efectos del sistema Objeto de procesamiento de audio (sAPO) efectos de audio para permitir que el autor de la llamada establezca el estado de los efectos.
SetChannelPriority

El método SetChannelPriority establece la prioridad de un canal MIDI.
SetDirectSound

El método SetDirectSound conecta el receptor del sintetizador con un objeto DirectSound existente y un búfer de DirectSound.
SetMasterClock

El método SetMasterClock proporciona al sintetizador un origen de hora maestro, que el sintetizador requiere para sincronizarse con el resto de DirectMusic.
SetMasterClock

El método SetMasterClock proporciona el receptor de synth con un origen de hora maestro, que es necesario para la sincronización con el resto de DirectMusic.
SetNumChannelGroups

El método SetNumChannelGroups indica al sintetizador que establezca su número de grupos de canales en un nuevo valor.
SetSynthSink

El método SetSynthSink establece la conexión del sintetizador al receptor de onda.
SetValue

Este método establece un valor de propiedad o reemplaza o quita un valor existente.
StopVoice

StopVoice no es compatible y puede modificarse o no estar disponible en el futuro.
Descargar

El método Unload descarga un recurso DLS (datos de forma de onda o de articulación para un instrumento MIDI) descargado previamente por una llamada a IDirectMusicSynth::D ownload.
UnlockForProcess

El método UnlockForProcess libera el bloqueo impuesto en el APO por el método LockForProcess.

Interfaces

 
IApoAcousticEchoCancellation

Esta interfaz la implementan las API para habilitar escenarios de cancelación de eco acústico (AEC).
IApoAuxiliaryInputConfiguration

Proporciona métodos que las API pueden implementar para que el motor de audio pueda agregar y quitar flujos de entrada auxiliares.
IApoAuxiliaryInputRT

Interfaz segura en tiempo real que se usa para controlar las entradas auxiliares de un APO.
IAudioDeviceModulesClient

Los objetos de procesamiento de audio (APO) implementan esta interfaz para obtener una referencia a una instancia de IAudioDeviceModulesManager .
IAudioMediaType

La interfaz IAudioMediaType expone métodos que permiten a un sAPO obtener información que se usa para negociar con el motor de audio para el formato de datos de audio adecuado.
IAudioProcessingObject

Los objetos de procesamiento de audio (sAPOs) de efectos del sistema se usan normalmente en subprocesos de proceso en tiempo real o a los que se llama desde subprocesos de proceso en tiempo real.
IAudioProcessingObjectConfiguration

La interfaz IAudioProcessingObjectConfiguration se usa para configurar el APO. Esta interfaz usa sus métodos para bloquear y desbloquear el APO para su procesamiento.
IAudioProcessingObjectLoggingService

Representa un servicio de registro para las API.
IAudioProcessingObjectNotifications

Implementado por los clientes para registrarse y recibir notificaciones comunes relacionadas con audio para el punto de conexión de APO y las notificaciones de efectos del sistema.
IAudioProcessingObjectRT

Esta interfaz puede funcionar en modo en tiempo real y sus métodos se pueden llamar subprocesos de procesamiento en tiempo real.
IAudioProcessingObjectRTQueueService

Representa un servicio de cola de trabajo en tiempo real para las API.
IAudioSystemEffects

La interfaz IAudioSystemEffects usa los métodos básicos que se heredan de IUnknown y debe implementar un método Initialize.
IAudioSystemEffects2

La interfaz IAudioSystemEffects2 se introdujo con Windows 8.1 para recuperar información sobre los objetos de procesamiento en un modo determinado.
IAudioSystemEffects3

Implementado por clientes que requieren que se pase una estructura APOInitSystemEffects3 al método IAudioProcessingObject::Initialize.
IAudioSystemEffectsCustomFormats

La interfaz IAudioSystemEffectsCustomFormats es compatible con Windows Vista y versiones posteriores de Windows.
IDirectMusicSynth

DirectMusicSynth usa la interfaz IDirectMusicSynth para comunicarse con sintetizadores en modo usuario.
IDirectMusicSynth8

IDirectMusicSynth8 no compatible y puede modificarse o no estar disponible en el futuro.
IDirectMusicSynthSink

La interfaz IDirectMusicSynthSink ahora está en gran medida obsoleta y solo es compatible con versiones de DirectMusic antes de DirectX 8.
IPropertyStore

Esta interfaz expone métodos usados para enumerar y manipular valores de propiedad.

Estructuras

 
APO_NOTIFICATION

Representa una notificación para un cambio en un punto de conexión de APO o efectos del sistema.
APO_NOTIFICATION_DESCRIPTOR

Especifica una notificación de APO solicitada.
APO_REG_PROPERTIES

IAudioProcessingObject::GetRegistrationProperties usa la estructura APO_REG_PROPERTIES para devolver las propiedades de registro de un objeto de procesamiento de audio (APO).
APOInitBaseStruct

La estructura APOInitBaseStruct es el encabezado de inicialización base que debe preceder a otros datos de inicialización en IAudioProcessingObject::Initialize.
APOInitSystemEffects

La estructura APOInitSystemEffects se pasa al APO de efectos del sistema para la inicialización.
APOInitSystemEffects2

La estructura APOInitSystemEffects2 se introdujo con Windows 8.1, para que sea posible proporcionar contexto de inicialización adicional al objeto de procesamiento de audio (APO) para la inicialización.
APOInitSystemEffects3

Proporciona parámetros de inicialización de APO, ampliando APOInitSystemEffects2 para agregar la capacidad de especificar un proveedor de servicios para el registro.
AUDIO_ENDPOINT_PROPERTY_CHANGE_APO_NOTIFICATION_DESCRIPTOR

Especifica una notificación de APO de cambio de propiedad de punto de conexión.
AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION

Representa una notificación de APO de cambio de propiedad.
AUDIO_ENDPOINT_VOLUME_APO_NOTIFICATION_DESCRIPTOR

Especifica una notificación de APO de volumen de punto de conexión.
AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION

Representa una notificación de APO de cambio de volumen de punto de conexión de audio.
AUDIO_SYSTEMEFFECT

Representa un efecto de audio del objeto de procesamiento de audio (sAPO) de efectos del sistema.
AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION

Representa una notificación de APO de efecto de audio del sistema.
DMUS_VOICE_STATE

DMUS_VOICE_STATE no se admite y puede modificarse o no estar disponible en el futuro.
KSP_PINMODE

La estructura KSP_PINMODE especifica la propiedad pin y los modos de procesamiento de audio admitidos para un generador de patillas.
MDEVICECAPSEX

La estructura MDEVICECAPSEX contiene información de funcionalidad del dispositivo para controladores de dispositivo de Plug and Play (PnP).
MIDIOPENDESC

La estructura MIDIOPENDESC es una estructura rellenada por el cliente que proporciona información sobre cómo abrir un dispositivo MIDI.
UNCOMPRESSEDAUDIOFORMAT

La estructura UNCOMPRESSEDAUDIOFORMAT especifica la velocidad de fotogramas, la máscara de canal y otros atributos del formato de datos de audio sin comprimir.
WAVEFORMATEX

La estructura WAVEFORMATEX especifica el formato de datos de una secuencia de audio de onda.