Метод IMDSPDeviceControl::Record (mswmdm.h)

Статья
08/25/2023

Метод Record начинает запись из входных данных внешней записи устройства в текущей позиции поиска. Сначала необходимо вызвать метод Seek .

Синтаксис

HRESULT Record(
  [in] _WAVEFORMATEX *pFormat
);

Параметры

[in] pFormat

Указатель на _WAVEFORMATEX структуру, содержащую формат, в котором должны быть записаны данные.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_BUSY	Устройство уже выполняет операцию.
WMDM_E_NOTSUPPORTED	Функция записи не реализована на этом устройстве.
E_FAIL	Произошла неизвестная ошибка.

Этот метод используется для вызова записи устройства (записи звуковой дорожки, которая будет храниться на устройстве мультимедиа) и потоковой передачи звуковых данных с устройства мультимедиа, записываемого на компьютер. Метод Seek определяет, какая форма записи происходит.

Некоторые устройства не поддерживают ни один из типов записи. Перед началом записи необходимо вызвать метод GetCapabilities . При попытке записи неподдерживаемого типа этот метод возвращает WMDM_E_NOTSUPPORTED.

Можно указать аргумент для параметра pFormat , чтобы указать формат звуковых данных для записи. Чтобы определить форматы, поддерживаемые устройством, см. статью IMDSPDevice::GetFormatSupport. Если параметр pFormat имеет значение NULL, устройство записывает звуковые данные в формате по умолчанию.

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