acmStreamUnprepareHeader-Funktion (msacm.h)
Die Funktion acmStreamUnprepareHeader bereinigt die Vorbereitung, die von der acmStreamPrepareHeader-Funktion für einen ACM-Stream ausgeführt wird. Diese Funktion muss aufgerufen werden, nachdem der ACM mit den angegebenen Puffern abgeschlossen wurde. Eine Anwendung muss diese Funktion aufrufen, bevor die Quell- und Zielpuffer freigegeben werden.
Syntax
MMRESULT ACMAPI acmStreamUnprepareHeader(
HACMSTREAM has,
LPACMSTREAMHEADER pash,
DWORD fdwUnprepare
);
Parameter
has
Handle mit dem Konvertierungsdampf.
pash
Zeiger auf eine ACMSTREAMHEADER-Struktur , die die Quell- und Zielpuffer identifiziert, die nicht vorbereitet sind.
fdwUnprepare
Reserviert; muss null sein.
Rückgabewert
Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler. Mögliche Fehlerwerte sind:
| Rückgabecode | Beschreibung |
|---|---|
|
Der in pash angegebene Streamheader wird derzeit verwendet und kann nicht unvorbereitet sein. |
|
Der in pash angegebene Streamheader wird derzeit nicht von der Funktion acmStreamPrepareHeader vorbereitet. |
|
Mindestens ein Flag ist ungültig. |
|
Das angegebene Handle ist ungültig. |
|
Mindestens ein Parameter ist ungültig. |
Hinweise
Das Aufheben der Vorbereitung eines bereits nicht vorbereiteten Streamheaders ist ein Fehler. Eine Anwendung muss die Quell- und Zielpufferlängen (cbSrcLength bzw . cbDstLength) angeben, die während eines Aufrufs des entsprechenden acmStreamPrepareHeaders verwendet wurden. Wenn diese Memberwerte nicht zurückgesetzt werden, schlägt acmStreamUnprepareHeader mit einem MMSYSERR_INVALPARAM Fehler fehl.
Der ACM kann nach einigen Fehlern wiederhergestellt werden. Der ACM gibt einen nonzero-Fehler zurück, aber der Streamheader ist ordnungsgemäß nicht vorbereitet. Um zu ermitteln, ob der Streamheader tatsächlich nicht vorbereitet war, kann eine Anwendung das flag ACMSTREAMHEADER_STATUSF_PREPARED untersuchen. Wenn acmStreamUnprepareHeader erfolgreich zurückgibt, ist der Header immer nicht vorbereitet.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | msacm.h |
| Bibliothek | Msacm32.lib |
| DLL | Msacm32.dll |