acmStreamUnprepareHeader-Funktion (msacm.h)

  • Artikel

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
ACMERR_BUSY
 Der in pash angegebene Streamheader wird derzeit verwendet und kann nicht unvorbereitet sein.
ACMERR_UNPREPARED
 Der in pash angegebene Streamheader wird derzeit nicht von der Funktion acmStreamPrepareHeader vorbereitet.
MMSYSERR_INVALFLAG
 Mindestens ein Flag ist ungültig.
MMSYSERR_INVALHANDLE
 Das angegebene Handle ist ungültig.
MMSYSERR_INVALPARAM
 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

Weitere Informationen

Audiokomprimierungsfunktionen

Audiokomprimierungs-Manager