Метод IDvdControl2::SetGPRM (strmif.h)

Статья
07/28/2023

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Метод SetGPRM задает общее значение регистра параметра.

Синтаксис

HRESULT SetGPRM(
  [in]  ULONG   ulIndex,
  [in]  WORD    wValue,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Параметры

[in] ulIndex

Регистрировать индекс; может быть значением от нуля до 15.

[in] wValue

16-разрядное значение, содержащееся в указанном регистре.

[in] dwFlags

Побитовое ИЛИ одного или нескольких флагов из перечисления DVD_CMD_FLAGS , указывающее способ синхронизации команды.

[out] ppCmd

Получает указатель на объект IDvdCmd, который можно использовать для синхронизации команд DVD. Вызывающий объект должен освободить интерфейс . Этот параметр может принимать значение NULL. Дополнительные сведения см. в разделе Синхронизация команд DVD.

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

Возвращает одно из следующих значений.

Код возврата	Описание
S_OK	Успешно.
E_INVALIDARG	Параметр ulIndex больше 15, или любые другие входные параметры недопустимы.

DVD-диск использует общие регистры параметров для хранения различных типов информации. Задав один или несколько из этих регистров вручную, приложение может предоставить определенные пользовательские функции. Это расширенная команда, которую не следует использовать, если у вас нет глубокого понимания спецификации DVD.

В следующей таблице приведено имя команды Приложения J, которой соответствует это имя метода, и домены, в которых этот метод является допустимым.

Имя команды Приложения J	Допустимые домены
нет	Все

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	strmif.h (включая Dshow.h)
Библиотека	Strmiids.lib

См. также раздел

Приложения DVD

Коды ошибок и успешного выполнения

Интерфейс IDvdControl2

IDvdInfo2::GetAllGPRMs

Поделиться через