Informazioni di riferimento su DDI per dispositivi audio

Articolo
10/05/2023

Panoramica della tecnologia di riferimento DDI per dispositivi audio.

Per sviluppare informazioni di riferimento su Dispositivi audio DDI, sono necessarie queste intestazioni:

Per indicazioni sulla programmazione per questa tecnologia, vedere:

Informazioni di riferimento su DDI per dispositivi audio

Enumerazioni


APO_FLAG L'enumerazione APO_FLAG definisce costanti usate come flag da un oggetto di elaborazione audio (APO).
APO_LOG_LEVEL Specifica il livello di un evento APO registrato con IAudioProcessingObjectLoggingService::ApoLog.
APO_NOTIFICATION_TYPE Specifica il tipo di un APO_NOTIFICATION.
APO_REFERENCE_STREAM_PROPERTIES Specifica le proprietà del flusso di loopback per il metodo callback IApoAcousticEchoCancellation2::GetDesiredReferenceStreamProperties.
AUDIO_SYSTEMEFFECT_STATE Specifica lo stato di un effetto audio sAPO (System Effects Audio Processing Object).
DEVICE_ORIENTATION_TYPE Specifica i valori di orientamento del dispositivo per le notifiche di tipo APO_NOTIFICATION_TYPE_DEVICE_ORIENTATION.
KSPROPERTY_AUDIOEFFECTSDISCOVERY L'enumerazione KSPROPERTY_AUDIOEFFECTSDISCOVERY definisce una costante utilizzata dall'elenco di oggetti di elaborazione audio (API).

Funzioni


AcceptInput Fornisce l'input all'APO in uno dei relativi input ausiliari.
AddAuxiliaryInput Aggiunge un input ausiliario all'APO e fornisce parametri di inizializzazione.
AERT_Allocate La funzione di utilità AERT_Allocate alloca e blocca un segmento di memoria da usare dagli oggetti di elaborazione audio.
AERT_Free La funzione di utilità AERT_Free rilascia memoria (libera) bloccata dalla funzione AERT_Allocate, per l'uso da parte di oggetti di elaborazione audio per elaborare i dati audio.
ApoLog Registra un evento APO.
APOProcess Il metodo APOProcess causa il passaggio di un'elaborazione da parte dell'APO.
CalcInputFrames Il metodo CalcInputFrames restituisce il numero di fotogrammi di input necessari per generare un determinato numero di fotogrammi di output.
CalcOutputFrames Il metodo CalcOutputFrames restituisce il numero di fotogrammi di output necessari per un determinato numero di fotogrammi di input.
Eseguire il commit Dopo aver apportato una modifica, questo metodo salva le modifiche.
CreateAudioMediaType La funzione CreateAudioMediaType usa il formato specificato dal chiamante per creare un oggetto tipo di supporto che descrive il formato audio.
CreateAudioMediaTypeFromUncompressedAudioFormat La funzione CreateAudioMediaTypeFromUncompressedAudioFormat usa le informazioni fornite nella struttura UNCOMPRESSEDAUDIOFORMAT per creare un oggetto tipo di supporto che descrive il formato audio.
GetApoNotificationRegistrationInfo Chiamato dal sistema per consentire ai client di registrare per ricevere callback di notifica per gli endpoint APO e le notifiche degli effetti di sistema.
GetApoNotificationRegistrationInfo2 Chiamato dal sistema per consentire ai client di registrare per ricevere callback di notifica per gli endpoint APO e le notifiche degli effetti di sistema. Questo metodo aggiunge un parametro che può essere usato per determinare i tipi di notifiche supportati nella versione di Windows in esecuzione nel dispositivo corrente.
GetAt Ottiene una chiave di proprietà dalla matrice di proprietà di un elemento.
GetAudioFormat Il metodo GetAudioFormat restituisce la struttura WAVEFORMATEX per il formato dati audio.
GetControllableSystemEffectsList Implementato dagli effetti audio di System Effects Audio Processing Object (sAPO) per consentire al chiamante di ottenere l'elenco corrente degli effetti.
GetCount Questo metodo restituisce un conteggio del numero di proprietà associate al file.
GetDesiredReferenceStreamProperties Richiede un set di proprietà per il flusso di loopback, se sono supportati nell'endpoint audio associato.
GetEffectsList Il metodo GetEffectsList viene usato per recuperare l'elenco degli effetti di elaborazione audio attualmente attivi e archivia un evento da segnalare se l'elenco cambia.
Getformat Il metodo GetFormat recupera una rappresentazione IAudioMediaType di un formato personalizzato.
GetFormatCount Il metodo GetFormatCount recupera il numero di formati personalizzati supportati dall'oggetto di elaborazione audio degli effetti di sistema (sAPO).
GetFormatRepresentation Il metodo GetFormatRepresentation recupera una rappresentazione stringa del formato personalizzato in modo che possa essere visualizzata in un'interfaccia utente.
GetInputChannelCount GetInputChannelCount restituisce il conteggio dei canali di input (esempi per frame) per l'APO.
GetLatency Il metodo GetLatency restituisce la latenza per l'APO. La latenza è la quantità di tempo necessario per attraversare il passaggio di elaborazione di un'APO.
GetPreferredInputFormat Funzione di callback che consente alle API di specificare un formato di input preferito per il formato di output specificato.
GetPreferredOutputFormat Funzione di callback che consente alle API di specificare un formato di output preferito per il formato di input specificato.
GetRealTimeWorkQueue Ottiene l'ID di una coda di lavoro che l'APO può usare per pianificare le attività che devono essere eseguite in tempo reale.
GetRegistrationProperties GetRegistrationProperties restituisce le proprietà di registrazione dell'oggetto di elaborazione audio (APO).
GetUncompressedAudioFormat IAudioMediaType::GetUncompressedAudioFormat restituisce informazioni sul formato dati audio.
GetValue Questo metodo recupera i dati per una proprietà specifica.
HandleNotification Chiamato dal sistema per notificare ai client modifiche agli endpoint o agli effetti di sistema dell'APO.
Initialize Il metodo Initialize inizializza l'APO e supporta i dati di lunghezza variabile.
IsCompressedFormat Il metodo IsCompressedFormat determina se il formato dati audio è un formato compresso.
IsEqual Il metodo IsEqual confronta due tipi di supporti e determina se sono identici.
IsInputFormatSupported Verifica che un formato di input ausiliario specifico sia supportato dall'APO.
IsInputFormatSupported Questo metodo negozia con il motore audio di Windows Vista per stabilire un formato di dati per il flusso di dati audio.
IsOutputFormatSupported Il metodo IsOutputFormatSupported viene usato per verificare che sia supportato un formato di output specifico.
LockForProcess Il metodo LockForProcess viene usato per verificare che l'APO sia bloccato e pronto per elaborare i dati.
RemoveAuxiliaryInput Rimuove un input ausiliario dall'APO.
Reimpostazione Il metodo Reset reimposta l'APO allo stato originale. Questo metodo non causa modifiche negli oggetti di connessione collegati all'input o all'output dell'APO.
SetAudioDeviceModulesManager Chiamato dal sistema per passare un'istanza di IAudioDeviceModulesManager a oggetti di elaborazione audio (API) che implementano l'interfaccia IAudioDeviceModulesClient .
SetAudioSystemEffectState Implementato dagli effetti audio di System Effects Audio Processing Object (sAPO) per consentire al chiamante di impostare lo stato degli effetti.
SetValue Questo metodo imposta un valore di proprietà o sostituisce o rimuove un valore esistente.
UnlockForProcess Il metodo UnlockForProcess rilascia il blocco imposto all'APO dal metodo LockForProcess.

Interfacce


IApoAcousticEchoCancellation Questa interfaccia viene implementata dalle API per abilitare scenari di annullamento dell'eco acustico (AEC).
IApoAcousticEchoCancellation2 Estende IAcousticEchoCancellation per consentire alle API di specificare le proprietà desiderate del flusso di riferimento.
IApoAuxiliaryInputConfiguration Fornisce metodi che le API possono implementare in modo che il motore audio possa aggiungere e rimuovere flussi di input ausiliari.
IApoAuxiliaryInputRT Interfaccia sicura in tempo reale usata per guidare gli input ausiliari di un'APO.
IAudioDeviceModulesClient Gli oggetti di elaborazione audio implementano questa interfaccia per ottenere un riferimento a un'istanza di IAudioDeviceModulesManager .
IAudioMediaType L'interfaccia IAudioMediaType espone i metodi che consentono a un sAPO di ottenere informazioni usate per negoziare con il motore audio per il formato di dati audio appropriato.
IAudioProcessingObject Gli oggetti di elaborazione audio degli effetti di sistema (sAPOs) vengono in genere usati in o chiamati da thread di elaborazione in tempo reale.
IAudioProcessingObjectConfiguration L'interfaccia IAudioProcessingObjectConfiguration viene usata per configurare l'APO. Questa interfaccia usa i metodi per bloccare e sbloccare l'APO per l'elaborazione.
IAudioProcessingObjectLoggingService Rappresenta un servizio di registrazione per le API.
IAudioProcessingObjectNotifications Implementata dai client per registrare e ricevere notifiche audio comuni per l'endpoint APO e le notifiche degli effetti del sistema.
IAudioProcessingObjectNotifications2 Implementata dai client per registrare e ricevere notifiche audio comuni per l'endpoint APO e le notifiche degli effetti del sistema. Questa interfaccia aggiunge la possibilità di determinare i tipi di notifiche supportati nella versione di Windows in esecuzione nel dispositivo corrente.
IAudioProcessingObjectPreferredFormatSupport Questa interfaccia viene implementata dalle API per consentire loro di specificare formati di input o output preferiti.
IAudioProcessingObjectRT Questa interfaccia può funzionare in modalità in tempo reale e i relativi metodi possono essere chiamati thread di elaborazione in tempo reale.
IAudioProcessingObjectRTQueueService Rappresenta un servizio di coda di lavoro in tempo reale per le API.
IAudioSystemEffects L'interfaccia IAudioSystemEffects usa i metodi di base ereditati da IUnknown e deve implementare un metodo Initialize.
IAudioSystemEffects2 L'interfaccia IAudioSystemEffects2 è stata introdotta con Windows 8.1 per recuperare informazioni sugli oggetti di elaborazione in una determinata modalità.
IAudioSystemEffects3 Implementato dai client che richiedono il passaggio di una struttura APOInitSystemEffects3 al metodo IAudioProcessingObject::Initialize.
IAudioSystemEffectsCustomFormats L'interfaccia IAudioSystemEffectsCustomFormats è supportata in Windows Vista e versioni successive di Windows.
Ipropertystore Questa interfaccia espone metodi usati per enumerare e modificare i valori delle proprietà.

Strutture


AcousticEchoCanceller_Reference_Input Contiene informazioni espanse relative alla configurazione di AEC (Acoustic Echo Cancellation) corrente.
APO_NOTIFICATION Rappresenta una notifica per una modifica a un endpoint APO o agli effetti di sistema.
APO_NOTIFICATION_DESCRIPTOR Specifica una notifica APO richiesta.
APO_REG_PROPERTIES La struttura APO_REG_PROPERTIES viene usata da IAudioProcessingObject::GetRegistrationProperties per restituire le proprietà di registrazione di un oggetto di elaborazione audio (APO).
APOInitBaseStruct La struttura APOInitBaseStruct è l'intestazione di inizializzazione di base che deve precedere altri dati di inizializzazione in IAudioProcessingObject::Initialize.
APOInitSystemEffects La struttura APOInitSystemEffects viene passata all'APO degli effetti di sistema per l'inizializzazione.
APOInitSystemEffects2 La struttura APOInitSystemEffects2 è stata introdotta con Windows 8.1, per rendere possibile fornire un contesto di inizializzazione aggiuntivo all'oggetto di elaborazione audio (APO) per l'inizializzazione.
APOInitSystemEffects3 Fornisce parametri di inizializzazione APO, estensione di APOInitSystemEffects2 per aggiungere la possibilità di specificare un provider di servizi per la registrazione.
AUDIO_ENDPOINT_PROPERTY_CHANGE_APO_NOTIFICATION_DESCRIPTOR Specifica una notifica apo di modifica della proprietà dell'endpoint.
AUDIO_ENDPOINT_PROPERTY_CHANGE_NOTIFICATION Rappresenta una notifica APO di modifica della proprietà.
AUDIO_ENDPOINT_VOLUME_APO_NOTIFICATION_DESCRIPTOR Specifica una notifica APO del volume dell'endpoint.
AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION Rappresenta una notifica apo di modifica del volume dell'endpoint audio.
AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2 Rappresenta una notifica apo di modifica del volume dell'endpoint audio. Si tratta di una versione aggiornata di AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION che fornisce informazioni aggiuntive sull'evento di modifica del volume.
AUDIO_ENVIRONMENT_STATE_CHANGE_NOTIFICATION Rappresenta una notifica APO di modifica dell'ambiente audio.
AUDIO_MICROPHONE_BOOST_APO_NOTIFICATION_DESCRIPTOR Specifica una notifica apo di aumento del microfono dell'endpoint.
AUDIO_MICROPHONE_BOOST_NOTIFICATION Rappresenta una notifica apo di aumento del microfono audio.
AUDIO_SYSTEMEFFECT Rappresenta un effetto audio sAPO (System Effects Audio Processing Object).
AUDIO_SYSTEMEFFECTS_PROPERTY_CHANGE_NOTIFICATION Rappresenta una notifica APO dell'effetto audio del sistema.
AUDIO_VOLUME_NOTIFICATION_DATA2 Rappresenta informazioni su un evento di notifica delle modifiche del volume. Questa struttura viene utilizzata dalla struttura AUDIO_ENDPOINT_VOLUME_CHANGE_NOTIFICATION2.
KSP_PINMODE La struttura KSP_PINMODE specifica la proprietà pin e le modalità di elaborazione audio supportate per una factory di pin.
MDEVICECAPSEX La struttura MDEVICECAPSEX contiene informazioni sulle funzionalità del dispositivo per i driver di dispositivo Plug and Play (PnP).
MIDIOPENDESC La struttura MIDIOPENDESC è una struttura piena di client che fornisce informazioni su come aprire un dispositivo MIDI.
UNCOMPRESSEDAUDIOFORMAT La struttura UNCOMPRESSEDAUDIOFORMAT specifica la frequenza dei fotogrammi, la maschera di canale e altri attributi del formato dati audio non compresso.
WAVEFORMATEX La struttura WAVEFORMATEX specifica il formato di dati di un flusso audio d'onda.

Condividi tramite

Informazioni di riferimento su DDI per dispositivi audio

Enumerazioni

Funzioni

Interfacce

Strutture

Commenti e suggerimenti

Risorse aggiuntive