acmStreamSize-Funktion (msacm.h)
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 |
|---|---|
|
Der angeforderte Vorgang kann nicht ausgeführt werden. |
|
Mindestens ein Flag ist ungültig. |
|
Das angegebene Handle ist ungültig. |
|
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 |