IMediaFilter::GetState
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este método determina estado do filtro.
Syntax
HRESULT GetState(
DWORD dwMilliSecsTimeout,
FILTER_STATE* State
);
Parameters
- dwMilliSecsTimeout
[no] Duração do tempo limite, em milissegundos. Para bloco indefinidamente, transmitir infinito.
- Estado
[out] Estado retornado do filtro. Incluem estados parado, em pausa, execução, ou intermediário (no processo de alteração).
Return Value
Retorna S_OK se o estado execução, em pausa ou inativo; caso contrário, retorna VFW_S_STATE_INTERMEDIATE Se a transição não estiver completo (o tempo limite expirado). O estado retornado na maiúsculas e minúsculas a último é aquele que está sendo alterado para.
Remarks
Geralmente, os filtros processador irão retornar VFW_S_STATE_INTERMEDIATE Até que recebem dados suficientes para processar at least um exemplo. Em algumas circunstâncias, um filtro irá localizar que ele pode fornecer dados em todos os fluxos suas saída. Essa condição geralmente ocorre devido incomuns ou incorreto dados. Um exemplo de dados incomuns pode ser uma apresentação slide MPEG, onde vídeo quadros ocorrer com pouca freqüência nos dados mas áudio é contínuo. Neste maiúsculas e minúsculas, um vídeo quadro no vídeo transmitir não pode ser encontrado até um determinado ponto no áudio transmitir. Se o filtro descobre que ela não pode completo de estado alteração (para este ou qualquer outro motivo), ele poderá retornar VFW_S_CANT_CUE.
Quando um aplicativo chama o filtro gráfico do Gerenciador IMediaControl::GetState método, o filtro gráfico Gerenciador chamadas GetState Sobre o filtro e continuará a pesquisar. Se receber o filtro gráfico Gerenciador VFW_S_CANT_CUE voltar a partir de filtro, ele retorna esse valor para o aplicativo do seu IMediaControl::GetState método.
Requirements
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later |