Compartir a través de

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

  • Artículo

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El SetGPRM método establece un valor de registro de parámetros general.

Sintaxis

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

Parámetros

[in] ulIndex

Registrar índice; puede ser un valor de cero a 15.

[in] wValue

Valor de 16 bits incluido en el registro especificado.

[in] dwFlags

OR bit a bit de una o varias marcas de la enumeración DVD_CMD_FLAGS , especificando cómo sincronizar el comando.

[out] ppCmd

Recibe un puntero a un objeto IDvdCmd que se puede usar para sincronizar comandos de DVD. El autor de la llamada debe liberar la interfaz . Este parámetro puede ser NULL. Para obtener más información, vea Sincronizar comandos de DVD.

Valor devuelto

Devuelve uno de los valores siguientes.

Código devuelto Descripción
S_OK
 Correcto.
E_INVALIDARG
 El parámetro ulIndex es mayor que 15 o cualquier otro de los parámetros de entrada no son válidos.

Comentarios

Un disco DVD usa registros de parámetros generales para almacenar varios tipos de información. Al establecer manualmente uno o varios de estos registros, es posible que una aplicación pueda proporcionar cierta funcionalidad personalizada. Se trata de un comando avanzado y no debe usarse a menos que tenga un conocimiento exhaustivo de la especificación de DVD.

En la tabla siguiente se muestra el nombre del comando Anexo J al que corresponde este nombre de método y los dominios en los que este método es válido.

Nombre de comando de Anexo J Dominios válidos
ninguno All

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado strmif.h (incluya Dshow.h)
Library Strmiids.lib

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

Interfaz IDvdControl2

IDvdInfo2::GetAllGPRMs