Método IAMVfwCaptureDialogs::ShowDialog (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 ShowDialog
método exibe a caixa de diálogo VFW especificada.
Sintaxe
HRESULT ShowDialog(
[in] int iDialog,
[in] HWND hwnd
);
Parâmetros
[in] iDialog
Caixa de diálogo a ser exibida. Esse é um membro da enumeração VfwCaptureDialogs .
[in] hwnd
Identificador da janela pai da caixa de diálogo.
Retornar valor
Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.
Código de retorno | Descrição |
---|---|
|
Argumento inválido. |
|
Êxito. |
|
Não foi possível reconectar com o novo formato. |
|
O grafo de filtro não foi interrompido. |
Comentários
Pare o grafo de filtro antes de chamar esse método. Caso contrário, o método falhará e retornará VFW_E_NOT_STOPPED.
A caixa de diálogo Formato de Vídeo (VfwCaptureDialog_Format) pode alterar o formato de vídeo. Nesse caso, o método tenta reconectar o filtro de captura. Se o filtro downstream rejeitar o novo formato, o método retornará VFW_E_CANNOT_CONNECT.
Requisitos
Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | strmif.h (inclua Dshow.h) |
Biblioteca | Strmiids.lib |