Método IMFVirtualCamera::Start (mfvirtualcamera.h)
Cria e registra a câmera virtual.
Sintaxe
HRESULT Start(
IMFAsyncCallback *pCallback
);
Parâmetros
pCallback
Ponteiro opcional para um objeto IMFAsyncCallback que o pipeline usará para notificar o chamador do estado da câmera virtual. O retorno de chamada, se fornecido, pode ser invocado com um IMFMediaEvent. Quando invocado, o método IMFMediaEvent::GetType retornará um MEExtendedType ou um MEError. Se um MEExtendedType for retornado, o método IMFMediaEvent::GetExtendedType poderá retornar um dos seguintes tipos de evento:
| Tipo de evento estendido | Descrição |
|---|---|
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_INITIALIZE | A fonte de mídia personalizada que representa a câmera virtual foi inicializada por um aplicativo. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_START | Um fluxo (ou fluxos) na fonte de mídia personalizada da câmera virtual foi iniciado por um aplicativo. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_STOP | Todos os fluxos na fonte de mídia personalizada da câmera virtual foram interrompidos pelo aplicativo. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_UNINITIALIZE | A fonte de mídia personalizada da câmera virtual não foi inicializada. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_PIPELINE_SHUTDOWN | O pipeline da câmera virtual foi desligado. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_CUSTOM_EVENT | Um evento personalizado foi gerado pela fonte de mídia personalizada da câmera virtual. O esquema do IMFMediaEvent é específico do fornecedor. |
O retorno de chamada pode ser chamado a qualquer momento depois que IMFVirtualCamera::Start tiver retornado com êxito.
Retornar valor
Retorna um valor HRESULT, incluindo, mas não se limitando aos seguintes valores:
| Código do erro | Descrição |
|---|---|
| S_OK | Com sucesso |
| E_INVALIDARG | Um parâmetro de entrada é inválido. |
Comentários
Até que uma chamada bem-sucedida para o método Start tenha sido feita, IMFVirtualCamera representa as informações de configuração da câmera virtual e a câmera virtual subjacente ainda não existe - a menos que o MFCreateVirtualCamera esteja reabrindo uma câmera virtual existente. Depois que Start for chamado com êxito, o IMFAttributes do qual IMFVirtualCamera herda conterá o nome simbólico da câmera virtual recém-criada, MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK.
Se MFCreateVirtualCamera for chamado com os mesmos parâmetros de uma chamada anterior, especificando um IMFVirtualCamera que já foi iniciado com uma chamada bem-sucedida para IMFVirtualCamera::Start, o resultado IMFVirtualCamera já está em um estado válido e chamadas subsequentes para IMFVirtualCamera::Start podem ser usadas para registrar novos retornos de chamada.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Build 22000 |
| Cabeçalho | mfvirtualcamera.h |
| Biblioteca | mfsensorgroup.lib |
| DLL | mfsensorgroup.dll |