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 |
---|---|
|
Êxito. |
|
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 |