Estrutura ACMSTREAMHEADER (msacm.h)
A estrutura ACMSTREAMHEADER define o cabeçalho usado para identificar um par de buffers de origem e de destino de conversão do ACM para um fluxo de conversão.
Sintaxe
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;
Membros
cbStruct
Tamanho, em bytes, da estrutura ACMSTREAMHEADER . Esse membro deve ser inicializado antes que o aplicativo chame qualquer função de fluxo do ACM usando essa estrutura. O tamanho especificado neste membro deve ser grande o suficiente para conter a estrutura base ACMSTREAMHEADER .
fdwStatus
Sinalizadores que dão informações sobre os buffers de conversão. Esse membro deve ser inicializado como zero antes que o aplicativo chame a função acmStreamPrepareHeader e não deve ser modificado pelo aplicativo enquanto o cabeçalho do fluxo permanece preparado.
| Nome | Descrição |
|---|---|
|
Definido pelo ACM ou driver para indicar que ele foi concluído com a conversão e está retornando os buffers para o aplicativo. |
|
Definido pelo ACM ou driver para indicar que os buffers estão na fila para conversão. |
|
Definido pelo ACM para indicar que os buffers foram preparados usando a função acmStreamPrepareHeader . |
dwUser
Dados do usuário. Isso pode ser qualquer dado de instância especificado pelo aplicativo.
pbSrc
Ponteiro para o buffer de origem. Esse ponteiro sempre deve se referir ao mesmo local enquanto o cabeçalho do fluxo permanece preparado. Se um aplicativo precisar alterar o local de origem, ele deverá despreparar o cabeçalho e reprepare-o com o local alternativo.
cbSrcLength
Comprimento, em bytes, do buffer de origem apontado por pbSrc. Quando o cabeçalho estiver preparado, esse membro deverá especificar o tamanho máximo que será usado no buffer de origem. As conversões podem ser executadas em comprimentos de origem menores ou iguais ao tamanho original preparado. No entanto, esse membro deve ser redefinido para o tamanho original quando um aplicativo desprepara o cabeçalho.
cbSrcLengthUsed
Quantidade de dados, em bytes, usados para a conversão. Esse membro não é válido até que a conversão seja concluída. Esse valor pode ser menor ou igual a cbSrcLength. Um aplicativo deve usar o membro cbSrcLengthUsed ao avançar para a próxima parte dos dados de origem para o fluxo de conversão.
dwSrcUser
Dados do usuário. Isso pode ser qualquer dado de instância especificado pelo aplicativo.
pbDst
Ponteiro para o buffer de destino. Esse ponteiro sempre deve se referir ao mesmo local enquanto o cabeçalho do fluxo permanece preparado. Se um aplicativo precisar alterar o local de destino, ele deverá despreparar o cabeçalho e reprepare-o com o local alternativo.
cbDstLength
Comprimento, em bytes, do buffer de destino apontado por pbDst. Quando o cabeçalho estiver preparado, esse membro deverá especificar o tamanho máximo que será usado no buffer de destino.
cbDstLengthUsed
Quantidade de dados, em bytes, retornados por uma conversão. Esse membro não é válido até que a conversão seja concluída. Esse valor pode ser menor ou igual a cbDstLength. Um aplicativo deve usar o membro cbDstLengthUsed ao avançar para o próximo local de destino para o fluxo de conversão.
dwDstUser
Dados do usuário. Isso pode ser qualquer dado de instância especificado pelo aplicativo.
dwReservedDriver[_DRVRESERVED]
Reservado; não use. Esse membro não requer nenhuma inicialização pelo aplicativo e nunca deve ser modificado enquanto o cabeçalho permanece preparado.
Comentários
Antes que uma estrutura ACMSTREAMHEADER possa ser usada para uma conversão, ela deve ser preparada usando a função acmStreamPrepareHeader . Quando um aplicativo é concluído com uma estrutura ACMSTREAMHEADER , ele deve chamar a função acmStreamUnprepareHeader antes de liberar os buffers de origem e destino.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | msacm.h |
Confira também
Gerenciador de Compactação de Áudio