Partager via


Méthode IPresentationManager ::CancelPresentsFrom (presentation.h)

Annule tous les cadeaux émis précédemment et toujours en cours d’exécution qui n’ont pas encore été affichés et dont les ID présents sont au moins le passé dans presentIdToCancelFrom.

Syntaxe

HRESULT CancelPresentsFrom(
  UINT64 presentIdToCancelFrom
);

Paramètres

presentIdToCancelFrom

Type : UINT64

Identificateur du présent à partir duquel annuler les présentes qui ont été émises mais qui ne sont pas encore affichées.

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK; sinon, elle retourne une HRESULT valeur qui indique l’erreur.

Remarques

Si des cadeaux dans le passé ont déjà été affichés, cet appel n’échouera pas. Ces cadeaux ne seront tout simplement pas annulés. La clôture de mise hors service actuelle ne sera pas signalée pour les cadeaux annulés, car lorsque les cadeaux sont annulés, ils n’affectent pas le présent actuellement affiché ou ne l’obligent pas à commencer le processus de mise hors service. Pour cette raison, il est suggéré qu’après avoir effectué un présent, une application interroge les événements de mémoire tampon disponibles pour rechercher une mémoire tampon disponible à émettre sur le premier présent après une annulation. Une fois que ce présent est mis en file d’attente, il permet au présent affiché précédemment de commencer le processus de mise hors service et de signaler la clôture de mise hors service actuelle.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Build 22000
Serveur minimal pris en charge Windows Build 22000
En-tête presentation.h
Bibliothèque dcomp.lib
DLL dcomp.dll

Voir aussi

IPresentationBuffer ::GetAvailableEvent