DisplayTaskResult.PresentId Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der die Anzahl der Geschenke darstellt, die für ein bestimmtes DisplayTaskPool angefordert wurden.
public:
property unsigned long long PresentId { unsigned long long get(); };uint64_t PresentId();public ulong PresentId { get; }var uInt64 = displayTaskResult.presentId;Public ReadOnly Property PresentId As ULongEigenschaftswert
Ein UINT64-Typbezeichner, der die Anzahl der Geschenke darstellt, die für einen bestimmten DisplayTaskPool angefordert wurden.
Hinweise
Der zurückgegebene Wert wird bei jedem Aufruf von DisplayTaskPool.TryExecuteTask für einen bestimmten DisplayTaskPool monoton um 1 erhöht, unabhängig davon, ob tryExecuteTaskDisplayPresentStatus.Succeeded in DisplayTaskResult.PresentStatus zurückgegeben hat.
Das einzige Szenario, in dem PresentId nicht erhöht wird, besteht darin, dass Sie TryExecuteTask mit ungültigen Parametern aufrufen und die Überprüfung der DirectDisplay-Laufzeit fehlschlägt, bevor sie in den Kernel aufruft. In diesen Fällen schlägt TryExecuteTask sofort fehl und gibt ein HRESULT zurück. Für ein neues DisplayTaskPool-Objekt wird PresentId auf 0 zurückgesetzt, und die erste TryExecuteTask gibt eine PresentId von 1 zurück.
Eine der gängigen Verwendungen von PresentId ist, dass Sie es verwenden können, um eine Wartezeit auf einen Zaun zu setzen, der als Eingabe für DisplayTask.SetSignal verwendet wird.