Interface IAMOpenProgress (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.]

A IAMOpenProgress interface relata o progresso de uma operação de abertura de arquivo e permite que o aplicativo cancele a operação.

Os filtros que abrem arquivos em uma rede podem expor essa interface. Um aplicativo pode usá-lo para consultar o progresso do download ou para cancelar o download. Se a rede não for responsiva, um método como IGraphBuilder::RenderFile poderá ser bloqueado por um período indefinido. Para impedir que seu aplicativo bloqueie, crie um thread de trabalho que usa IAMOpenProgress para monitorar o progresso. O thread de trabalho poderá cancelar a operação se ocorrer um tempo limite predefinido ou em resposta a um comando do usuário.

O filtro URL (Fonte de Arquivo) dá suporte a essa interface.

Herança

A interface IAMOpenProgress herda da interface IUnknown . IAMOpenProgress também tem estes tipos de membros:

Métodos

A interface IAMOpenProgress tem esses métodos.

 
IAMOpenProgress::AbortOperation

O método AbortOperation cancela a operação de abertura de arquivo.
IAMOpenProgress::QueryProgress

O método QueryProgress recupera o progresso da operação de abertura de arquivo.

Requisitos

Requisito Valor
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)