Acmstreamheader

typedef struct {

DWORD cbStruct;

DWORD fdwStatus;

DWORD dwUser;

LPBYTE pbSrc;

DWORD cbSrcLength;

DWORD cbSrcLengthUsed;

DWORD dwSrcUser;

LPBYTE pbDst;

DWORD cbDstLength;

DWORD cbDstLengthUsed;

DWORD dwDstUser;

DWORD dwReservedDriver[10];

} ACMSTREAMHEADER;

Переменные

0. cbStruct — размер в байтах объекта структуры ACMSTREAMHEADER. Данная переменная должна быть инициализирована прежде, чем ACM вызовет любую потоковую функцию, использующую данный объект структуры. Размер, указанный в этой переменной должен быть достаточно большим, чтобы содержать базовую структуру ACMSTREAMHEADER.

1. fdwStatus — флаги, содержащие информацию о буферах преобразования. Эта переменная должна иметь нулевое значение перед вызовом в приложении функции acmStreamPrepareHeader и приложение не должно изменять её значение пока дескриптор потока остаётся подготовленным. Данная переменная может содержать следующие флаги:

• ACMSTREAMHEADER_STATUSF_DONE — устанавливается ACM или драйвером для обозначения того, что он закончил преобразование и передал буфер приложению.

• ACMSTREAMHEADER_STATUSF_INQUEUE — устанавливается ACM или драйвером для обозначения того, что буфер поставлен в очередь на преобразование.

• ACMSTREAMHEADER_STATUSF_PREPARED — устанавливается ACM для обозначения того, что буфер был подготовлен с использованием функции acmStreamPrepareHeader.

0. dwUser — пользовательские данные. В этом аргументе могут передаваться любые данные, необходимые приложению.

1. pbSrc — указатель на исходный буфер. Этот указатель не должен изменять своего значения пока дескриптор потока остаётся подготовленным. Если приложению требуется изменить положение буфера, оно должно разблокировать дескриптор и подготовить его заново для нового положения буфера.

2. cbSrcLength — длина исходного буфера, на который указывает переменная pbSrc, в байтах. Если буфер подготовлен, данная переменная должна содержать максимальный размер, который может быть использован под исходный буфер. Преобразование можно произвести только для фрагментов, имеющих длину меньшую или равную длине первоначально подготовленного буфера. Однако эта переменная должна быть возвращена в своё исходное значение при разблокировании буфера в приложении.

3. cbSrcLengthUsed — размер в байтах преобразованного блока данных из исходного буфера. Эта переменная содержит некорректное значение до завершения процесса преобразования. Значение данной переменной может быть меньше или равно значению переменной cbSrcLength. Приложение может использовать значение переменной cbSrcLengthUsed при определении начала следующего блока исходных данных, передаваемого для преобразования из входного потока.

4. dwSrcUser — пользовательские данные. Может содержать любую информацию, используемую приложением.

5. pbDst — указатель на буфер, в который будут записаны результаты преобразования. Этот указатель не должен изменять своего значения пока дескриптор потока остаётся подготовленным. Если приложению требуется изменить положение буфера, оно должно разблокировать дескриптор и подготовить его заново для нового положения буфера.

6. cbDstLength — длина исходного буфера, на который указывает переменная pbDst, в байтах. Если буфер подготовлен, данная переменная должна содержать максимальный размер, который может быть использован под буфер результата.

7. cbDstLengthUsed — размер в байтах преобразованного блока данных в буфере результата. Эта переменная содержит некорректное значение до завершения процесса преобразования. Значение данной переменной может быть меньше или равно значению переменной cbDstLength. Приложение может использовать значение переменной cbDstLengthUsed при определении конца преобразованного блока данных в буфере результата.

8. dwDstUser — пользовательские данные. Может содержать любую информацию, используемую приложением.

9. dwReservedDriver — зарезервировано для дальнейшего использования. Эта переменная не нуждается в инициализации и её значение не может быть изменено, значения пока дескриптор потока остаётся подготовленным.

Примечание

Объект структуры ACMSTREAMHEADER содержит дескриптор, используемый для идентификации исходного буфера и буфера результата при преобразовании форматов средствами ACM.

Прежде, чем объект структуры ACMSTREAMHEADER сможет быть использован для преобразования, он должен быть подготовлен функцией acmStreamPrepareHeader. После того, как приложение завершит свою работу с объектом структуры ACMSTREAMHEADER, необходимо перед освобождением исходного буфера и буфера результата вызвать функцию acmStreamUnprepareHeader.

Описание данной структуры содержится в файле заголовка msacm.h.