Méthode CCmdQueue.New

Article
07/28/2023

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La New méthode initialise une commande à exécuter et retourne un nouvel objet CDeferredCommand .

Syntaxe

virtual HRESULT New(
   CDeferredCommand **ppCmd,
   LPUNKNOWN        pUnk,
   REFTIME          time,
   GUID             *iid,
   long             dispidMethod,
   short            wFlags,
   long             cArgs,
   VARIANT          *pDispParams,
   VARIANT          *pvarResult,
   short            *puArgErr,
   BOOL             bStream
);

Paramètres

ppCmd: Adresse d’un pointeur vers un objet CDeferredCommand par lequel une application peut annuler la commande, définir une nouvelle heure de présentation pour celle-ci ou récupérer des informations d’estimation.
Punk: Pointeur vers l’objet qui exécutera la commande.
time: Heure à laquelle exécuter la ou les commandes mises en file d’attente.
Iid: Pointeur vers l’identificateur global unique (GUID) de l’interface à appeler.
dispidMethod: Méthode sur l’interface à appeler.
wFlags: Indicateurs décrivant le contexte de l'appel. Ce paramètre prend en charge les mêmes indicateurs que la méthode IDispatch::Invoke .
cArgs: Nombre d’arguments passés.
pDispParams: Pointeur vers la liste des types de variantes associés aux paramètres de répartition.
pvarResult: Pointeur vers la liste dans laquelle les résultats, le cas échéant, doivent être retournés.
puArgErr: Pointeur vers l’index dans la liste de paramètres pDispParams où la dernière erreur s’est produite.
bStream: Valeur indiquant si le paramètre time est une valeur de temps de flux (TRUE) ou une valeur d’heure de présentation (FALSE).

Valeur renvoyée

Retourne S_OK en cas de réussite. Renvoie E_OUTOFMEMORY si ppCmd retourne après la création de l’objet CDeferredCommand avec la valeur NULL. Sinon, retourne un HRESULT qui indique une erreur lors de la tentative de création d’un objet CDeferredCommand . En cas d’erreur, aucun objet n’a été mis en file d’attente.

Notes

Le nouvel objet CDeferredCommand sera initialisé avec les paramètres et sera ajouté à la file d’attente pendant la construction. Cette méthode est similaire à la méthode IDispatch::Invoke .

Les valeurs du paramètre wFlags sont les suivantes :

Valeur	Description
DISPATCH_METHOD	Le membre est en cours d’exécution en tant que méthode. Si une propriété porte le même nom, cet indicateur et l’indicateur DISPATCH_PROPERTYGET peuvent être définis.
DISPATCH_PROPERTYGET	Le membre est récupéré en tant que membre de propriété ou de données.
DISPATCH_PROPERTYPUT	Le membre est modifié en tant que membre de propriété ou de données.
DISPATCH_PROPERTYPUTREF	Le membre est modifié par le biais d’une attribution de référence, plutôt que d’une attribution de valeur. Cette valeur est valide uniquement lorsque la propriété accepte une référence à un objet.

Configuration requise

Condition requise	Valeur
En-tête	Winutil.h (include Streams.h)
Bibliothèque	Strmbase.lib (builds de vente au détail) ; Strmbasd.lib (builds de débogage)

Voir aussi

CCmdQueue, classe

Partager via