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 |