Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |