Método IMFCaptureEngineOnEventCallback::OnEvent (mfcaptureengine.h)
Chamado pelo mecanismo de captura para notificar a aplicação de um evento de captura.
Sintaxe
HRESULT OnEvent(
[in] IMFMediaEvent *pEvent
);
Parâmetros
[in] pEvent
Um ponteiro para a interface IMFMediaEvent . Use essa interface para obter informações sobre o evento, conforme descrito em Comentários.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Para obter o tipo de evento, chame IMFMediaEvent::GetExtendedType. Esse método retorna um dos GUIDs a seguir.
| GUID | Descrição |
|---|---|
| MF_CAPTURE_ENGINE_ALL_EFFECTS_REMOVED | O método IMFCaptureSource::RemoveAllEffects foi concluído. |
| MF_CAPTURE_ENGINE_CAMERA_STREAM_BLOCKED | A captura de vídeo foi bloqueada pelo driver. |
| MF_CAPTURE_ENGINE_CAMERA_STREAM_UNBLOCKED | A captura de vídeo foi restaurada pelo driver depois de ter sido bloqueada. |
| MF_CAPTURE_ENGINE_EFFECT_ADDED | O método IMFCaptureSource::AddEffect foi concluído. |
| MF_CAPTURE_ENGINE_EFFECT_REMOVED | O método IMFCaptureSource::RemoveEffect foi concluído. |
| MF_CAPTURE_ENGINE_ERROR | Ocorreu um erro durante a captura. |
| MF_CAPTURE_ENGINE_INITIALIZED | O método IMFCaptureEngine::Initialize foi concluído. |
| MF_CAPTURE_ENGINE_PHOTO_TAKEN | O método IMFCaptureEngine::TakePhoto foi concluído. |
| MF_CAPTURE_ENGINE_PREVIEW_STARTED | O método IMFCaptureEngine::StartPreview foi concluído. |
| MF_CAPTURE_ENGINE_PREVIEW_STOPPED | O método IMFCaptureEngine::StopPreview foi concluído. |
| MF_CAPTURE_ENGINE_RECORD_STARTED | O método IMFCaptureEngine::StartRecord foi concluído. |
| MF_CAPTURE_ENGINE_RECORD_STOPPED | O método IMFCaptureEngine::StopRecord foi concluído. |
| MF_CAPTURE_SINK_PREPARED | O método IMFCaptureSink::P repare foi concluído. |
| MF_CAPTURE_SOURCE_CURRENT_DEVICE_MEDIA_TYPE_SET | O método IMFCaptureSource::SetCurrentDeviceMediaType foi concluído. |
Esse método pode ser chamado de um thread de trabalho. A implementação deve ser thread-safe.
Para obter o código status do evento, chame IMFMediaEvent::GetStatus. Se o código status for um código de erro, ele indicará que a operação solicitada falhou.
Além disso, o objeto de evento especificado por pEvent pode conter qualquer um dos atributos a seguir.
Para obter atributos de evento, use a interface IMFAttributes , herdada por IMFMediaEvent .Requisitos
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | mfcaptureengine.h |