Metodo IDiscFormat2TrackAtOnce::AddAudioTrack (imapi2.h)

Articolo
08/24/2023

Scrive il flusso di dati nel supporto corrente come nuova traccia.

Sintassi

HRESULT AddAudioTrack(
  [in] IStream *data
);

Parametri

[in] data

Interfaccia IStream dei dati audio da scrivere come traccia successiva sul supporto.

Il formato dati contiene campioni audio non elaborati a 44,1 KHz, stereo a 16 bit. Questo è lo stesso formato usato dagli esempi audio in un file audio WAV Microsoft (senza l'intestazione).

Valore restituito

S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice restituito	Descrizione
E_POINTER	Puntatore non valido. Valore: 0x80004003
E_IMAPI_DF2TAO_MEDIA_IS_NOT_PREPARED	L'operazione richiesta è valida solo quando il supporto è stato "preparato". Valore: 0xC0AA0502
E_IMAPI_DF2TAO_WRITE_IN_PROGRESS	Attualmente è in corso un'operazione di scrittura. Valore: 0xC0AA0500
E_IMAPI_DF2TAO_TRACK_LIMIT_REACHED	I supporti CD-R e CD-RW supportano un massimo di 99 tracce audio. Valore: 0xC0AA0508
E_IMAPI_DF2TAO_STREAM_NOT_SUPPORTED	Il flusso audio fornito non è valido. Valore: 0xC0AA050D
E_IMAPI_DF2TAO_NOT_ENOUGH_SPACE	Non è disponibile spazio sufficiente sul supporto per aggiungere la traccia audio fornita. Valore: 0xC0AA0509
E_FAIL	Errore non specificato. Valore: 0x80004005
E_INVALIDARG	Uno o più argomenti non sono validi. Valore: 0x80070057
E_OUTOFMEMORY	Impossibile allocare la memoria richiesta. Valore: 0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	Il dispositivo non è riuscito ad accettare il comando entro il periodo di timeout. Ciò può essere causato dall'immissione di uno stato incoerente del dispositivo oppure potrebbe essere necessario aumentare il valore di timeout per il comando. Valore: 0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	Il dispositivo ha segnalato dati imprevisti o non validi per un comando. Valore: 0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	Il supporto viene inserito a capovolto. Valore: 0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	L'unità ha segnalato che è in fase di preparazione. Riprovare la richiesta in un secondo momento. Valore: 0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	Non sono presenti supporti nel dispositivo. Valore: 0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	Il supporto è attualmente formattato. Attendere il completamento del formato prima di tentare di usare il supporto. Valore: 0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	L'unità ha segnalato che sta eseguendo un'operazione a esecuzione prolungata, ad esempio il completamento di una scrittura. L'unità può essere inutilizzabile per un lungo periodo di tempo. Valore: 0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	La scrittura non è riuscita perché l'unità non ha ricevuto dati abbastanza rapidamente per continuare la scrittura. Lo spostamento dei dati di origine nel computer locale, la riduzione della velocità di scrittura o l'abilitazione di un'impostazione "buffer underrun free" può risolvere questo problema. Valore: 0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	Il supporto non è compatibile o con un formato fisico sconosciuto. Valore: 0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	La struttura DVD non è presente. Ciò può essere causato dall'uso di unità/supporto incompatibili. Valore: 0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	Il dispositivo ha segnalato che la pagina in modalità richiesta (e tipo) non è presente. Valore: 0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	L'unità ha segnalato che la combinazione di parametri forniti nella pagina della modalità per un comando MODE SELECT non è supportata. Valore: 0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	L'unità ha segnalato che il supporto è protetto da scrittura. Valore: 0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	La velocità del supporto non è compatibile con il dispositivo. Ciò può essere causato dall'uso di supporti di velocità superiori o inferiori rispetto all'intervallo di velocità supportato dal dispositivo. Valore: 0xC0AA020F
HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)	L'handle specificato non è valido. Valore: 6
HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)	La risorsa di rete o il dispositivo specificato non sono più disponibili. Valore: 55
E_IMAPI_RECORDER_LOCKED	Il dispositivo associato a questo registratore durante l'ultima operazione è stato bloccato esclusivamente, causando l'esito negativo di questa operazione. Valore: 0xC0AA0210
E_IMAPI_REQUEST_CANCELLED	La richiesta è stata annullata. Valore: 0xC0AA0002

Commenti

Prima di chiamare questo metodo, è necessario chiamare i metodi IDiscFormat2TrackAtOnce::p ut_Recorder e IDiscFormat2TrackAtOnce::P repareMedia .

È anche consigliabile chiamare i metodi seguenti se i valori predefiniti non sono appropriati per l'applicazione:

Per determinare lo stato di avanzamento dell'operazione di scrittura, è necessario implementare l'interfaccia DDiscFormat2TrackAtOnceEvents . Per esempi che illustrano come implementare un gestore eventi in uno script, vedere Monitoraggio dello stato di avanzamento con eventi.

I supporti possono ospitare 99 tracce di dati audio. Il numero di traccia inizia a 1. L'ultima traccia è 99.

Gli esempi di silenzio o di dati contenenti zero verranno aggiunti all'operazione di scrittura traccia nei modi seguenti:

La dimensione minima della traccia è di 4 secondi e, se necessario, i dati di traccia verranno ampliati per soddisfare questo requisito.
A causa della natura della registrazione in una sola volta, viene aggiunto un gap di due secondi tra tracce audio successive. Questo divario è normalmente nascosto dai giocatori basati su PC, ma può essere evidente su alcune apparecchiature elettroniche di consumo.

Requisiti


Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imapi2.h

Vedi anche

IDiscFormat2TrackAtOnce

IDiscFormat2TrackAtOnce::CancelAddTrack

Condividi tramite