acmStreamSize-Funktion (msacm.h)

  • Artikel

Die acmStreamSize-Funktion gibt eine empfohlene Größe für einen Quell- oder Zielpuffer in einem ACM-Stream zurück.

Syntax

MMRESULT ACMAPI acmStreamSize(
  HACMSTREAM has,
  DWORD      cbInput,
  LPDWORD    pdwOutputBytes,
  DWORD      fdwSize
);

Parameter

has

Handle für den Konvertierungsdatenstrom.

cbInput

Größe des Quell- oder Zielpuffers in Byte. Die fdwSize-Flags geben an, was der Eingabeparameter definiert. Dieser Parameter muss ungleich null sein.

pdwOutputBytes

Zeiger auf eine Variable, die die Größe des Quell- oder Zielpuffers in Byte enthält. Die fdwSize-Flags geben an, was der Ausgabeparameter definiert. Wenn die acmStreamSize-Funktion erfolgreich ist, wird dieser Speicherort immer mit einem Wert ungleich null gefüllt.

fdwSize

Flags für die Streamgrößenabfrage. Die folgenden Werte werden definiert:

Wert Bedeutung
ACM_STREAMSIZEF_DESTINATION Der cbInput-Parameter enthält die Größe des Zielpuffers. Der parameter pdwOutputBytes empfängt die empfohlene Quellpuffergröße in Bytes.
ACM_STREAMSIZEF_SOURCE Der cbInput-Parameter enthält die Größe des Quellpuffers. Der parameter pdwOutputBytes empfängt die empfohlene Zielpuffergröße in Bytes.

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt. Mögliche Fehlerwerte sind:

Rückgabecode Beschreibung
ACMERR_NOTPOSSIBLE
 Der angeforderte Vorgang kann nicht ausgeführt werden.
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

Eine Anwendung kann diese Funktion verwenden, um vorgeschlagene Puffergrößen für Quell- oder Zielpuffer zu bestimmen. Die zurückgegebenen Puffergrößen sind möglicherweise nur eine Schätzung der tatsächlichen Größen, die für die Konvertierung erforderlich sind. Da die tatsächlichen Konvertierungsgrößen nicht immer ohne Die Konvertierung bestimmt werden können, werden die zurückgegebenen Größen in der Regel überschätzt.

Im Falle eines Fehlers erhält der Speicherort, auf den pdwOutputBytes verweist, null. Dabei wird davon ausgegangen, dass der von pdwOutputBytes angegebene Zeiger gültig ist.

Anforderungen

Anforderung Wert
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