Compartilhar via


Método IMFVirtualCamera::GetMediaSource (mfvirtualcamera.h)

Obtém um IMFMediaSource que fornece dados de mídia da câmera virtual.

Sintaxe

HRESULT GetMediaSource(
  IMFMediaSource **ppMediaSource
);

Parâmetros

ppMediaSource

Um IMFMediaSource de cliente compartilhado da câmera virtual.

Retornar valor

Código do erro Descrição
S_OK Com sucesso

Comentários

GetMediaSource pode não ser chamado até que IMFVirtualCamera::Start tenha sido chamado com êxito. O IMFMediaSource retornado no parâmetro ppMediaSource é uma fonte de mídia que tem funcionalidade reduzida. Ele é marcado internamente como um cliente compartilhado. Essa fonte de mídia destina-se a aplicativos a serem usados como uma visualização local durante o processo de ativação e configuração da câmera virtual.

Se uma função completa IMFMediaSource for necessária, o aplicativo deverá chamar MFCreateDeviceSource usando o nome de link simbólico retornado no IMFAttributes após uma chamada IMFVirtualCamera::Start . Isso, no entanto, resultará na criação de uma fonte de mídia de controle exclusivo que, quando ativada, bloqueará todos os outros aplicativos usando a câmera virtual.

O tempo de vida do IMFMediaSource recuperado por esse método está diretamente vinculado ao tempo de vida do IMFVirtualCamera do qual ele é obtido. Se IMFVirtualCamera for descartado ou IMFVirtualCamera::Shutdown for chamado, o IMFMediaSource obtido desse método também será desligado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Build 22000
Cabeçalho mfvirtualcamera.h
Biblioteca mfsensorgroup.lib
DLL mfsensorgroup.dll

Confira também

IMFVirtualCamera::Start

MFCreateDeviceSource

IMFVirtualCamera::Shutdown