ACMSTREAMHEADER-Struktur (msacm.h)
Die ACMSTREAMHEADER-Struktur definiert den Header, mit dem eine ACM-Konvertierungsquelle und ein Zielpufferpaar für einen Konvertierungsdatenstrom identifiziert werden.
Syntax
typedef struct tACMSTREAMHEADER {
DWORD cbStruct;
DWORD fdwStatus;
DWORD_PTR dwUser;
LPBYTE pbSrc;
DWORD cbSrcLength;
DWORD cbSrcLengthUsed;
DWORD_PTR dwSrcUser;
LPBYTE pbDst;
DWORD cbDstLength;
DWORD cbDstLengthUsed;
DWORD_PTR dwDstUser;
DWORD dwReservedDriver[_DRVRESERVED];
} ACMSTREAMHEADER, *PACMSTREAMHEADER, *LPACMSTREAMHEADER;
Members
cbStruct
Größe der ACMSTREAMHEADER-Struktur in Byte. Dieser Member muss initialisiert werden, bevor die Anwendung ACM-Streamfunktionen mit dieser Struktur aufruft. Die in diesem Member angegebene Größe muss groß genug sein, um die ACMSTREAMHEADER-Basisstruktur zu enthalten.
fdwStatus
Flags, die Informationen zu den Konvertierungspuffern enthalten. Dieser Member muss auf null initialisiert werden, bevor die Anwendung die acmStreamPrepareHeader-Funktion aufruft , und sollte nicht von der Anwendung geändert werden, während der Streamheader vorbereitet bleibt.
| Name | BESCHREIBUNG |
|---|---|
|
Legen Sie vom ACM oder Treiber fest, um anzugeben, dass die Konvertierung abgeschlossen ist und die Puffer an die Anwendung zurückgegeben werden. |
|
Wird vom ACM oder Treiber festgelegt, um anzugeben, dass die Puffer für die Konvertierung in die Warteschlange eingereiht werden. |
|
Legen Sie vom ACM fest, um anzugeben, dass die Puffer mithilfe der Funktion acmStreamPrepareHeader vorbereitet wurden. |
dwUser
Benutzerdaten. Dabei kann es sich um beliebige instance daten, die von der Anwendung angegeben werden.
pbSrc
Zeiger auf den Quellpuffer. Dieser Zeiger muss immer auf denselben Speicherort verweisen, während der Streamheader vorbereitet bleibt. Wenn eine Anwendung den Quellspeicherort ändern muss, muss sie die Vorbereitung des Headers aufheben und ihn mit dem alternativen Speicherort erneut erstellen.
cbSrcLength
Länge des Quellpuffers in Bytes, auf den pbSrc verweist. Wenn der Header vorbereitet ist, muss dieser Member die maximale Größe angeben, die im Quellpuffer verwendet wird. Konvertierungen können für Quelllängen durchgeführt werden, die kleiner oder gleich der ursprünglichen vorbereiteten Größe sind. Dieser Member muss jedoch auf die ursprüngliche Größe zurückgesetzt werden, wenn eine Anwendung den Header nicht vorbereitet.
cbSrcLengthUsed
Datenmenge in Bytes, die für die Konvertierung verwendet wird. Dieser Member ist erst gültig, wenn die Konvertierung abgeschlossen ist. Dieser Wert kann kleiner oder gleich cbSrcLength sein. Eine Anwendung muss den cbSrcLengthUsed-Member verwenden, wenn sie zum nächsten Teil der Quelldaten für den Konvertierungsdatenstrom wechselt.
dwSrcUser
Benutzerdaten. Dabei kann es sich um beliebige instance daten, die von der Anwendung angegeben werden.
pbDst
Zeiger auf den Zielpuffer. Dieser Zeiger muss immer auf denselben Speicherort verweisen, während der Streamheader vorbereitet bleibt. Wenn eine Anwendung den Zielspeicherort ändern muss, muss sie die Vorbereitung des Headers aufheben und ihn mit dem alternativen Speicherort erneut erstellen.
cbDstLength
Länge des Zielpuffers in Byte, auf den pbDst verweist. Wenn der Header vorbereitet ist, muss dieser Member die maximale Größe angeben, die im Zielpuffer verwendet wird.
cbDstLengthUsed
Datenmenge in Bytes, die von einer Konvertierung zurückgegeben wird. Dieser Member ist erst gültig, wenn die Konvertierung abgeschlossen ist. Dieser Wert kann kleiner oder gleich cbDstLength sein. Eine Anwendung muss das cbDstLengthUsed-Element verwenden, wenn sie zum nächsten Zielspeicherort für den Konvertierungsdatenstrom wechselt.
dwDstUser
Benutzerdaten. Dabei kann es sich um beliebige instance daten, die von der Anwendung angegeben werden.
dwReservedDriver[_DRVRESERVED]
Reserviert; nicht verwenden. Dieser Member erfordert keine Initialisierung durch die Anwendung und sollte nie geändert werden, während der Header vorbereitet bleibt.
Hinweise
Bevor eine ACMSTREAMHEADER-Struktur für eine Konvertierung verwendet werden kann, muss sie mithilfe der Funktion acmStreamPrepareHeader vorbereitet werden. Wenn eine Anwendung mit einer ACMSTREAMHEADER-Struktur fertig ist, muss sie die Funktion acmStreamUnprepareHeader aufrufen, bevor die Quell- und Zielpuffer freigegeben werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | msacm.h |
Weitere Informationen
Audiokomprimierungs-Manager