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

[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 SetDVDDirectory método establece la unidad de DVD desde la que leerá el filtro navegador de DVD .

Sintaxis

HRESULT SetDVDDirectory(
  [in] LPCWSTR pszwPath
);

Parámetros

[in] pszwPath

Puntero a una cadena de caracteres anchos que especifica la ruta de acceso del directorio raíz.

Valor devuelto

Devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Correcto.
E_INVALIDARG	El parámetro pszwPath apunta a una ruta de acceso de DVD no válida o no se encuentra una unidad de DVD durante la enumeración.
E_UNEXPECTED	El navegador de DVD no se inicializa.
VFW_E_DVD_INVALIDDOMAIN	dominio no válido. Para conocer más detalles, vea la sección Comentarios.

Comentarios

Si pszwPath es NULL, el navegador de DVD intenta seleccionar un volumen de DVD en cualquier unidad disponible. Al iniciarse, el navegador de DVD busca automáticamente una unidad, comenzando en la unidad C, con una carpeta VIDEO_TS en la carpeta raíz. Por lo tanto, solo es necesario llamar SetDVDDirectory cuando tenga más de una unidad de DVD en una máquina, o si su letra de unidad de DVD es A o B. Al especificar la ruta de acceso, incluya la carpeta video_ts.

C++
SetDVDDirectory(L"e:\\video_ts");

Algunos volúmenes de DVD pueden tener su vídeo en un directorio denominado algo distinto de "video_ts". La idea general es que un "volumen de DVD" adicional (el conjunto de . IFO. VOB y . Los archivos BUP que normalmente se almacenarían en el directorio VIDEO_TS) se pueden colocar en un subdirectorio del disco. Al cambiar la raíz para que apunte a este directorio, MSWebDVD funcionará en este volumen de DVD independiente. Habrá disponible un nuevo conjunto de menús, títulos, etc., independientemente de los títulos de la VIDEO_TS raíz, que ya no será accesible. Estos directorios se denominan "directorios ocultos". En el ejemplo siguiente se muestra cómo establecer un directorio oculto como raíz, donde "hidden" es un marcador de posición para cualquier nombre que los autores de discos hayan dado al directorio.

C++
SetDVDDirectory(L"d:\\webdvd\\hidden");

Si el gráfico de filtros se está ejecutando y el navegador de DVD encuentra un DVD en el directorio especificado por pszwPath, el navegador de DVD comienza automáticamente a reproducir el disco. Esto se ajusta a la especificación de DVD y garantiza que el nuevo disco se inicializa correctamente. Si no desea que el nuevo disco se reproduzca automáticamente después SetDVDDirectory de la devolución, debe establecer la marca de DVD_ResetOnStop en IDvdControl2::SetOption en TRUE y detener el gráfico de filtros a través de una llamada a IMediaControl::Stop en el Administrador de gráficos de filtros. Si DVD_ResetOnStop se establece en FALSE, SetDVDDirectory devuelve VFW_E_DVD_INVALIDDOMAIN.

Este método se muestra en la aplicación DVDSample en CDvdCore::SetDirectory.

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 del comando Anexo J	Dominios válidos
Ninguno	DVD_DOMAIN_Stop

Requisitos

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 (incluye Dshow.h)
Library	Strmiids.lib

Consulte también

Aplicaciones de DVD

Códigos de error y éxito

IDvdControl2 (interfaz)