IDiscFormat2TrackAtOnce::AddAudioTrack-Methode (imapi2.h)
Schreibt den Datenstrom als neue Spur auf die aktuellen Medien.
Syntax
HRESULT AddAudioTrack(
[in] IStream *data
);
Parameter
[in] data
Eine IStream-Schnittstelle der Audiodaten, die als nächster Titel auf dem Medium geschrieben werden sollen.
Das Datenformat enthält 44,1 KHz, 16-Bit-Stereo, rohe Audiobeispiele. Dies ist das gleiche Format, das von den Audiobeispielen in einer Microsoft WAV-Audiodatei (ohne Header) verwendet wird.
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Zeiger ist ungültig.
Wert: 0x80004003 |
|
Der angeforderte Vorgang ist nur gültig, wenn Medien "vorbereitet" wurden.
Wert: 0xC0AA0502 |
|
Derzeit wird ein Schreibvorgang ausgeführt.
Wert: 0xC0AA0500 |
|
CD-R- und CD-RW-Medien unterstützen maximal 99 Audiospuren.
Wert: 0xC0AA0508 |
|
Der bereitgestellte Audiostream ist ungültig.
Wert: 0xC0AA050D |
|
Auf den Medien ist nicht genügend Speicherplatz vorhanden, um die bereitgestellte Audiospur hinzuzufügen. Wert: 0xC0AA0509 |
|
Unspezifizierter Fehler.
Wert: 0x80004005 |
|
Mindestens ein Argument ist ungültig.
Wert: 0x80070057 |
|
Fehler beim Zuweisen des erforderlichen Arbeitsspeichers.
Wert: 0x8007000E |
|
Das Gerät konnte den Befehl innerhalb des Timeoutzeitraums nicht annehmen. Dies kann dadurch verursacht werden, dass das Gerät einen inkonsistenten Zustand eingegeben hat, oder der Timeoutwert für den Befehl muss möglicherweise erhöht werden.
Wert: 0xC0AA020D |
|
Das Gerät hat unerwartete oder ungültige Daten für einen Befehl gemeldet.
Wert: 0xC0AA02FF |
|
Die Medien werden kopfüber eingefügt.
Wert: 0xC0AA0204 |
|
Das Laufwerk hat gemeldet, dass es gerade bereit ist. Versuchen Sie die Anforderung später erneut.
Wert: 0xC0AA0205 |
|
Das Gerät enthält keine Medien.
Wert: 0xC0AA0202 |
|
Die Medien werden derzeit formatiert. Warten Sie, bis das Format abgeschlossen ist, bevor Sie versuchen, die Medien zu verwenden.
Wert: 0xC0AA0206 |
|
Das Laufwerk hat gemeldet, dass es einen Vorgang mit langer Ausführung ausführt, z. B. das Beenden eines Schreibvorgangs. Das Laufwerk kann für einen längeren Zeitraum unbrauchbar sein.
Wert: 0xC0AA0207 |
|
Fehler beim Schreiben, da das Laufwerk daten nicht schnell genug empfangen hat, um mit dem Schreiben fortzufahren. Wenn Sie die Quelldaten auf den lokalen Computer verschieben, die Schreibgeschwindigkeit verringern oder die Einstellung "Pufferunterlauf frei" aktivieren, kann dieses Problem behoben werden.
Wert: 0xC0AA0300 |
|
Die Medien sind nicht kompatibel oder haben kein unbekanntes physisches Format.
Wert: 0xC0AA0203 |
|
Die DVD-Struktur ist nicht vorhanden. Dies kann durch inkompatibles Laufwerk/Medium verursacht werden.
Wert: 0xC0AA020E |
|
Das Gerät hat gemeldet, dass die angeforderte Modusseite (und der Typ) nicht vorhanden sind.
Wert: 0xC0AA0201 |
|
Das Laufwerk meldete, dass die Kombination von Parametern, die auf der Modusseite für einen MODUS SELECT-Befehl bereitgestellt wurden, nicht unterstützt wurde.
Wert: 0xC0AA0208 |
|
Das Laufwerk meldete, dass das Medium schreibgeschützt ist.
Wert: 0xC0AA0209 |
|
Die Geschwindigkeit des Mediums ist mit dem Gerät nicht kompatibel. Dies kann durch die Verwendung von Medien mit höherer oder niedrigerer Geschwindigkeit als der vom Gerät unterstützte Geschwindigkeitsbereich verursacht werden.
Wert: 0xC0AA020F |
|
Das angegebene Handle ist ungültig.
Wert: 6 |
|
Die angegebene Netzwerkressource oder das angegebene Gerät ist nicht mehr verfügbar.
Wert: 55 |
|
Das diesem Rekorder während des letzten Vorgangs zugeordnete Gerät wurde ausschließlich gesperrt, sodass dieser Vorgang nicht erfolgreich war.
Wert: 0xC0AA0210 |
|
Die Anforderung wurde abgebrochen.
Wert: 0xC0AA0002 |
Hinweise
Bevor Sie diese Methode aufrufen, müssen Sie die Methoden IDiscFormat2TrackAtOnce::p ut_Recorder und IDiscFormat2TrackAtOnce::P repareMedia aufrufen.
Sie sollten auch die folgenden Methoden aufrufen, wenn ihre Standardwerte nicht für Ihre Anwendung geeignet sind:
- IDiscFormat2TrackAtOnce::p ut_BufferUnderrunFreeDisabled
- IDiscFormat2TrackAtOnce::p ut_ClientName
- IDiscFormat2TrackAtOnce::p ut_DoNotFinalizeMedia
Die Medien können 99 Spuren von Audiodaten aufnehmen. Die Nummerierung der Spur beginnt bei 1. Der letzte Track ist 99.
Stille oder Datenbeispiele, die Nullen enthalten, werden dem Nachverfolgungsvorgang auf folgende Weise hinzugefügt:
- Die minimale Spurgröße beträgt 4 Sekunden, und bei Bedarf werden die Spurdaten erweitert, um diese Anforderung zu erfüllen.
- Aufgrund der Art der Track-at-Once-Aufzeichnung wird eine Zwei-Sekunden-Lücke zwischen aufeinander folgenden Audiospuren hinzugefügt. Diese Lücke wird normalerweise von PC-basierten Spielern ausgeblendet, kann sich jedoch auf einigen Unterhaltungselektronikgeräten bemerkbar machen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi2.h |