Método IDvdControl2::SetDVDDirectory (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 SetDVDDirectory método define a unidade de DVD da qual o filtro DVD Navigator lerá.

Sintaxe

HRESULT SetDVDDirectory(
  [in] LPCWSTR pszwPath
);

Parâmetros

[in] pszwPath

Ponteiro para uma cadeia de caracteres largos que especifica o caminho do diretório raiz.

Retornar valor

Retorna um dos valores a seguir.

Código de retorno	Descrição
S_OK	Êxito.
E_INVALIDARG	O parâmetro pszwPath aponta para um caminho de DVD inválido ou uma unidade de DVD não é encontrada durante a enumeração.
E_UNEXPECTED	O Navegador de DVD não é inicializado.
VFW_E_DVD_INVALIDDOMAIN	Domínio inválido. Para obter detalhes, consulte Observações.

Comentários

Se pszwPath for NULL, o Navegador de DVD tentará selecionar um volume de DVD em qualquer unidade disponível. Na inicialização, o Navegador de DVD procura automaticamente uma unidade, começando na unidade C, com uma pasta VIDEO_TS na pasta raiz. Portanto, só é necessário chamar SetDVDDirectory quando você tiver mais de uma unidade de DVD em um computador ou se a letra da unidade de DVD for A ou B. Ao especificar o caminho, inclua a pasta video_ts.

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

Alguns volumes de DVD podem ter seu vídeo em um diretório chamado algo diferente de "video_ts". A ideia geral é que um "volume de DVD" adicional (o conjunto de . IFO. VOB e . Os arquivos BUP que normalmente seriam armazenados no diretório VIDEO_TS) podem ser colocados em um subdiretório no disco. Alterando a raiz para apontar para esse diretório, o MSWebDVD operará nesse volume de DVD separado. Um novo conjunto de menus, títulos e assim por diante estará disponível, independentemente dos títulos na raiz VIDEO_TS, que não estarão mais acessíveis. Esses diretórios são chamados de "diretórios ocultos". O exemplo a seguir mostra como definir um diretório oculto como a raiz, em que "oculto" é um espaço reservado para qualquer nome que os autores de disco tenham dado ao diretório.

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

Se o grafo de filtro estiver em execução e o DVD Navigator encontrar um DVD no diretório especificado por pszwPath, o DVD Navigator começará a reproduzir automaticamente o disco. Isso está em conformidade com a especificação de DVD e garante que o novo disco seja inicializado corretamente. Se você não quiser que o novo disco seja reproduzido automaticamente após SetDVDDirectory o retorno, defina o sinalizador DVD_ResetOnStop em IDvdControl2::SetOption como TRUE e interrompa o grafo de filtro por meio de uma chamada para IMediaControl::Stop no Gerenciador de Grafo de Filtro. Se DVD_ResetOnStop estiver definido como FALSE, retornará SetDVDDirectory VFW_E_DVD_INVALIDDOMAIN.

Esse método é demonstrado no aplicativo DVDSample em CDvdCore::SetDirectory.

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	DVD_DOMAIN_Stop

Requisitos

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