Método IDvdInfo::GetRoot (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.

Nota La interfaz IDvdInfo está en desuso. En su lugar, use IDvdInfo2 .

 

Recupera el directorio raíz que se establece en el reproductor.

Sintaxis

HRESULT GetRoot(
  [out] LPSTR pRoot,
  [in]  ULONG ulBufSize,
  [out] ULONG *pulActualSize
);

Parámetros

[out] pRoot

Puntero al búfer para recibir la cadena raíz. Tenga en cuenta que la cadena raíz usa caracteres ANSI.

[in] ulBufSize

Tamaño del búfer pasado, en bytes.

[out] pulActualSize

Puntero a un valor que contiene el tamaño de los datos reales devueltos.

Valor devuelto

Devuelve un valor HRESULT .

Código devuelto	Descripción
E_UNEXPECTED	El DVD no se inicializa o el dominio no se DVD_DOMAIN_Title.
S_OK	Correcto.
VFW_E_DVD_INVALIDDOMAIN	La acción solicitada no se admite en este dominio (DVD_DOMAIN).
VFW_E_DVD_OPERATION_INHIBITED	La acción solicitada no puede producirse en este momento en la película debido a la creación del disco DVD-Video actual.

Comentarios

Si se encontró una raíz válida, este método devuelve la cadena raíz. De lo contrario, devuelve cero para pcbActualSize, lo que indica que no se ha encontrado o inicializado un directorio raíz válido.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	strmif.h (incluye Dshow.h)

Consulte también

Códigos de error y éxito

IDvdInfo (interfaz)