IMFVirtualCamera ::Start, méthode (mfvirtualcamera.h)
Crée et inscrit la caméra virtuelle.
Syntaxe
HRESULT Start(
IMFAsyncCallback *pCallback
);
Paramètres
pCallback
Pointeur facultatif vers un objet IMFAsyncCallback que le pipeline utilisera pour informer l’appelant de l’état de la caméra virtuelle. Le rappel, s’il est fourni, peut être appelé avec un IMFMediaEvent. Lorsqu’elle est appelée, la méthode IMFMediaEvent ::GetType retourne un MEExtendedType ou un MEError. Si un MEExtendedType est retourné, la méthode IMFMediaEvent ::GetExtendedType peut retourner l’un des types d’événements suivants :
| Type d’événement étendu | Description |
|---|---|
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_INITIALIZE | La source multimédia personnalisée représentant la caméra virtuelle a été initialisée par une application. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_START | Un flux (ou des flux) sur la source multimédia personnalisée de la caméra virtuelle a été démarré par une application. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_STOP | Tous les flux de la source multimédia personnalisée de la caméra virtuelle ont été arrêtés par l’application. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_SOURCE_UNINITIALIZE | La source multimédia personnalisée de la caméra virtuelle n’a pas été initialisée. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_PIPELINE_SHUTDOWN | Le pipeline de la caméra virtuelle a été arrêté. |
| MF_FRAMESERVER_VCAMEVENT_EXTENDED_CUSTOM_EVENT | Un événement personnalisé a été généré par la source multimédia personnalisée de la caméra virtuelle. Le schéma de l’événement IMFMediaEvent est propre au fournisseur. |
Le rappel peut être appelé à tout moment après le retour de IMFVirtualCamera ::Start .
Valeur retournée
Retourne une valeur HRESULT, y compris, mais sans s’y limiter, les valeurs suivantes :
| Code d'erreur | Description |
|---|---|
| S_OK | Opération réussie |
| E_INVALIDARG | Un paramètre d’entrée n’est pas valide. |
Remarques
Jusqu’à ce qu’un appel réussi à la méthode Start ait été effectué, IMFVirtualCamera représente les informations de configuration de la caméra virtuelle et la caméra virtuelle sous-jacente n’existe pas encore, sauf si mfCreateVirtualCamera réouvrira une caméra virtuelle existante. Une fois Start appelé avec succès, l’attribut IMFAttributes dont hérite IMFVirtualCamera contient le nom de lien symbolique de la caméra virtuelle nouvellement créée, MF_DEVSOURCE_ATTRIBUTE_SOURCE_TYPE_VIDCAP_SYMBOLIC_LINK.
Si MFCreateVirtualCamera est appelé avec les mêmes paramètres qu’un appel précédent, en spécifiant un IMFVirtualCamera qui a déjà démarré avec un appel réussi à IMFVirtualCamera ::Start, le résultat IMFVirtualCamera est déjà dans un état valide et les appels suivants à IMFVirtualCamera ::Start peuvent être utilisés pour inscrire de nouveaux rappels.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Build 22000 |
| En-tête | mfvirtualcamera.h |
| Bibliothèque | mfsensorgroup.lib |
| DLL | mfsensorgroup.dll |