AcmStreamUnprepareHeader

MMRESULT acmStreamUnprepareHeader( HACMSTREAM has, LPACMSTREAMHEADER pash, DWORD fdwUnprepare );

Возвращаемое значение

В случае успешного завершения возвращает нулевое значение. В противном случае возвращает одно из следующих значений:

• ACMERR_BUSY — дескриптор потока, указанный в аргументе pash в настоящее время используется и не может быть освобождён.

• ACMERR_UNPREPARED — дескриптор потока, указанный в аргументе pash в настоящее время не инициализирован функцией acmStreamPrepareHeader.

• MMSYSERR_INVALFLAG — при вызове данной функции установлен, по крайней мере, один недопустимый флаг.

• MMSYSERR_INVALHANDLE — использован недопустимый дескриптор.

• MMSYSERR_INVALPARAM — при вызове данной функции, по крайней мере, один из её аргументов имеет недопустимое значение.

• MMSYSERR_NOMEM — система не в состоянии разместить в памяти требуемые ресурсы.

Аргументы

0. has — дескриптор потока преобразования.

1. pash — указатель на объект структуры ACMSTREAMHEADER, содержащий указатели на освобождаемые исходный буфер и буфер результата.

2. fdwUnprepare — зарезервирован для дальнейшего использования. Должен иметь нулевое значение.

Примечание

Функция acmStreamUnprepareHeader отменяет результаты действия функции acmStreamPrepareHeader для потока ACM. Эта функция должна вызываться после того, как ACM закончит работу с подготовленными буферами перед их уничтожением.

Освобождение дескриптора потока, который не был до этого подготовлен, приводит к возникновению ошибки. Приложение должно восстановить в освобождаемом дескрипторе значения размеров буферов (переменных cbSrcLength и cbDstLength), установленные для них при вызове функции acmStreamPrepareHeader. Если первоначальные значения этих величин не будут восстановлены, функция acmStreamUnprepareHeader возвратит значение MMSYSERR_INVALPARAM. Возвращение ненулевой величины не всегда означает, что операция не завершилась успешно. Для проверки того, был ли освобождён дескриптор при возврате подобного сообщения, следует проверить состояние флага ACMSTREAMHEADER_STATUSF_PREPARED. Если функция acmStreamUnprepareHeader возвращает нулевое значение, дескриптор всегда освобождён.

Описание данной функции содержится в файле заголовка msacm.h. При работе с данной функцией следует включить в проект библиотеку msacm32.lib.

AfxGetApp

CWinApp* AfxGetApp( );

Возвращаемое значение

Указатель на единственный объект класса CWinApp данного приложения.

Примечание

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

AfxGetInstanceHandle

HINSTANCE AfxGetInstanceHandle( );

Возвращаемое значение

Дескриптор HINSTANCE текущей копии приложения. Если вызов данной функции произошёл из библиотеки динамической компоновки, связанной с версией USRDLL библиотеки MFC, возвращается дескриптор HINSTANCE данной библиотеки динамической компоновки (DLL).

Примечание

Данная функция позволяет получить дескриптор текущей копии приложения. Функция AfxGetInstanceHandle всегда возвращает объект HINSTANCE исполняемого в настоящее время файла (.exe), кроме случая, когда она вызывается из библиотеки динамической компоновки, связанной с версией USRDLL библиотеки MFC. В этом случае она возвращает дескриптор HINSTANCE данной библиотеки динамической компоновки.