Compartilhar via


Método IDvdControl2::SetGPRM (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O SetGPRM método define um valor de registro de parâmetro geral.

Sintaxe

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

Parâmetros

[in] ulIndex

Registrar índice; pode ser um valor de zero a 15.

[in] wValue

Um valor de 16 bits contido no registro especificado.

[in] dwFlags

OR bit a bit de um ou mais sinalizadores da enumeração DVD_CMD_FLAGS , especificando como sincronizar o comando.

[out] ppCmd

Recebe um ponteiro para um objeto IDvdCmd que pode ser usado para sincronizar comandos de DVD. O chamador deve liberar a interface. Este parâmetro pode ser NULL. Para obter mais informações, consulte Sincronizando comandos de DVD.

Retornar valor

Retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
Êxito.
E_INVALIDARG
O parâmetro ulIndex é maior que 15 ou qualquer outro dos parâmetros de entrada é inválido.

Comentários

Um disco de DVD usa registros de parâmetros gerais para armazenar vários tipos de informações. Ao definir manualmente um ou mais desses registros, um aplicativo pode ser capaz de fornecer determinadas funcionalidades personalizadas. Esse é um comando avançado e não deve ser usado, a menos que você tenha uma compreensão completa da especificação do DVD.

A tabela a seguir mostra o nome do comando Anexo J ao qual esse nome de método corresponde e os domínios nos quais esse método é válido.

Nome do Comando Do Anexo J Domínios válidos
nenhum Tudo

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho strmif.h (inclua Dshow.h)
Biblioteca Strmiids.lib

Confira também

Aplicativos DE DVD

Códigos de erro e êxito

IDvdControl2 Interface

IDvdInfo2::GetAllGPRMs