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

Crea y registra la cámara virtual.

Sintaxis

HRESULT Start(
  IMFAsyncCallback *pCallback
);

Parámetros

pCallback

Puntero opcional a un objeto IMFAsyncCallback que la canalización usará para notificar al autor de la llamada el estado de la cámara virtual. La devolución de llamada, si se proporciona, se puede invocar con un IMFMediaEvent. Cuando se invoca, el método IMFMediaEvent::GetType devolverá un MEExtendedType o un MEError. Si se devuelve un MEExtendedType , el método IMFMediaEvent::GetExtendedType puede devolver uno de los siguientes tipos de eventos:

Tipo de evento extendido	Descripción
MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_INITIALIZE	Una aplicación inicializó el origen multimedia personalizado que representa la cámara virtual.
MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_START	Una aplicación inició una secuencia (o secuencias) en el origen multimedia personalizado de la cámara virtual.
MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_STOP	La aplicación detuvo todas las secuencias del origen multimedia personalizado de la cámara virtual.
MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_UNINITIALIZE	El origen multimedia personalizado de la cámara virtual no se inicializó.
MF_FRAMESERVER_VCAMEVENT_EXTENDED_PIPELINE_SHUTDOWN	La canalización de la cámara virtual estaba apagada.
MF_FRAMESERVER_VCAMEVENT_EXTENDED_CUSTOM_EVENT	El origen de medios personalizados de la cámara virtual generó un evento personalizado. El esquema de IMFMediaEvent es específico del proveedor.

Se puede llamar a la devolución de llamada en cualquier momento después de que el IMFVirtualCamera::Start se haya devuelto correctamente.

Valor devuelto

Devuelve un valor HRESULT, incluidos, entre otros, los siguientes valores:

Código de error	Descripción
S_OK	Correcto
E_INVALIDARG	Un parámetro de entrada no es válido.

Comentarios

Hasta que se haya realizado una llamada correcta al método Start , IMFVirtualCamera representa la información de configuración de la cámara virtual y la cámara virtual subyacente aún no existe, a menos que MFCreateVirtualCamera vuelva a abrir una cámara virtual existente. Una vez que start se haya llamado correctamente, los IMFAttributes de los que IMFVirtualCamera hereda contendrán el nombre simbólico de la cámara virtual recién creado, MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK.

Si se llama a MFCreateVirtualCamera con los mismos parámetros que una llamada anterior, especificando un IMFVirtualCamera que ya se inició con una llamada correcta a IMFVirtualCamera::Start, el resultado IMFVirtualCamera ya está en un estado válido y las llamadas posteriores a IMFVirtualCamera::Start pueden usarse para registrar nuevas devoluciones de llamada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Build 22000
Encabezado	mfvirtualcamera.h
Library	mfsensorgroup.lib
Archivo DLL	mfsensorgroup.dll

Consulte también

IMFAsyncCallback

IMFMediaEvent

MFCreateVirtualCamera