Metodo IMFVirtualCamera::Start (mfvirtualcamera.h)
Crea e registra la fotocamera virtuale.
Sintassi
HRESULT Start(
IMFAsyncCallback *pCallback
);
Parametri
pCallback
Puntatore facoltativo a un oggetto IMFAsyncCallback che la pipeline userà per notificare al chiamante lo stato della fotocamera virtuale. Il callback, se specificato, può essere richiamato con un IMFMediaEvent. Quando viene richiamato, il metodo IMFMediaEvent::GetType restituirà un MEExtendedType o un MEError. Se viene restituito un MEExtendedType , il metodo IMFMediaEvent::GetExtendedType può restituire uno dei tipi di evento seguenti:
| Tipo di evento esteso | Descrizione |
|---|---|
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_INITIALIZE | L'origine multimediale personalizzata che rappresenta la fotocamera virtuale è stata inizializzata da un'applicazione. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_START | Un flusso (o flussi) nell'origine multimediale personalizzata della fotocamera virtuale è stato avviato da un'applicazione. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_STOP | Tutti i flussi nell'origine multimediale personalizzata della fotocamera virtuale sono stati arrestati dall'applicazione. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_UNINITIALIZE | L'origine multimediale personalizzata della fotocamera virtuale non è stata inizializzata. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_PIPELINE_SHUTDOWN | La pipeline della fotocamera virtuale è stata arrestata. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_CUSTOM_EVENT | Un evento personalizzato è stato generato dall'origine multimediale personalizzata della fotocamera virtuale. Lo schema per IMFMediaEvent è specifico del fornitore. |
Il callback può essere chiamato in qualsiasi momento dopo la restituzione di IMFVirtualCamera::Start .
Valore restituito
Restituisce un valore HRESULT, incluso, ma non limitato ai valori seguenti:
| Codice di errore | Descrizione |
|---|---|
| S_OK | Completato |
| E_INVALIDARG | Un parametro di input non è valido. |
Commenti
Fino a quando non viene effettuata una chiamata riuscita al metodo Start , IMFVirtualCamera rappresenta le informazioni di configurazione della fotocamera virtuale e la fotocamera virtuale sottostante non esiste ancora, a meno che MFCreateVirtualCamera non stia nuovamente aprendo una fotocamera virtuale esistente. Una volta che Start è stato chiamato correttamente, imfAttributes che IMFVirtualCamera eredita da conterrà il nome simbolico del collegamento simbolico della fotocamera virtuale appena creata, MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK.
Se MFCreateVirtualCamera viene chiamato con gli stessi parametri di una chiamata precedente, specificando un IMFVirtualCamera già avviato con una chiamata con esito positivo a IMFVirtualCamera::Start, il risultato IMFVirtualCamera è già in uno stato valido e le chiamate successive a IMFVirtualCamera::Start possono essere usate per registrare nuovi callback.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Build 22000 |
| Intestazione | mfvirtualcamera.h |
| Libreria | mfsensorgroup.lib |
| DLL | mfsensorgroup.dll |