DisplayTaskResult.PresentId 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
지정된 DisplayTaskPool에서 요청된 선물 수를 나타내는 값을 가져옵니다.
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 ULong속성 값
지정된 DisplayTaskPool에서 요청된 선물 수를 나타내는 UINT64 형식 식별자입니다.
설명
TryExecuteTask가 DisplayTaskResult.PresentStatus에서 DisplayPresentStatus.Succeeded를 반환했는지 여부에 관계없이 지정된 DisplayTaskPool에 대한 DisplayTaskPool.TryExecuteTask에 대한 모든 호출에서 반환되는 값은 단조롭게 1씩 증가합니다.
PresentId가 증가되지 않는 유일한 시나리오는 잘못된 매개 변수를 사용하여 TryExecuteTask를 호출하고 커널을 호출하기 전에 DirectDisplay 런타임 유효성 검사가 실패하는 경우입니다. 이러한 경우 TryExecuteTask 는 즉시 실패하고 HRESULT를 반환합니다. 새 DisplayTaskPool 개체의 경우 PresentId 가 0으로 다시 설정되고 첫 번째 TryExecuteTask 는 PresentId 가 1과 같은 값을 반환합니다.
PresentId의 일반적인 사용법 중 하나는 이를 사용하여 DisplayTask.SetSignal에 대한 입력으로 사용되는 펜스에 대기할 수 있다는 것입니다.