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

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 SetState método salva a posição atual do disco e o estado do filtro navegador de DVD .

Sintaxe

HRESULT SetState(
  [in]  IDvdState *pState,
  [in]  DWORD     dwFlags,
  [out] IDvdCmd   **ppCmd
);

Parâmetros

[in] pState

Ponteiro para a interface IDvdState no objeto que contém as informações de estado.

[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 S_OK se tiver êxito ou um valor HRESULT caso contrário.

Comentários

O Navegador de DVD usa as informações de localização no objeto de estado fornecido para restaurar a posição de reprodução para um local específico no disco.

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

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

Confira também

Aplicativos de DVD

Códigos de erro e êxito

IDvdControl2 Interface