Skip to main content

XDisplayAcquireTimeoutDeferral

画面タイムアウトの延期を取得します。

Syntax

Parameters

handle   _Out_
型: XDisplayTimeoutDeferralHandle*
画面タイムアウトの延期のハンドルへのポインター。

Return value

型: HRESULT 成功した場合は S_OK を返します。それ以外の場合はエラー コードを返します。エラー コードの一覧については、Error Codes を参照してください。

Remarks

この関数は、タイム センシティブ スレッドから呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
画面タイムアウトの延期により、ユーザーが何も操作しない間も画面が暗くなったり、ロックされたり、電源が切れたりしないようにします。一定のアイドル時間が経過すると、画面タイムアウトが発生します。画面タイムアウトが発生すると、デバイスはディスプレイを暗くしたり、ロック画面をアクティブにしたり、ディスプレイの電源を切ったりする場合があります。画面タイムアウトが発生するのに必要なアイドル時間の長さは、デバイスのユーザー設定によって異なります。ゲームがユーザーの操作を必要としないアクティビティ (ゲーム リソースの読み込みや長いカットシーンの表示など) を実行している場合、画面タイムアウトは不便な場合があります。画面タイムアウトの延期を取得することで、画面タイムアウトを防止できます。 画面タイムアウトの延期を取得するには、まず XDisplayAcquireTimeoutDeferral を呼び出して画面タイムアウトの延期のハンドルを取得し、そのハンドルが不要になったら XDisplayCloseTimeoutDeferralHandle を呼び出してハンドルを閉じます。ゲームがフォーカスを失うと画面タイムアウトの延期は無視され、ゲームが終了すると解放されます。
この関数を使用して画面タイムアウトの延期ハンドルを取得した場合、XDisplayCloseTimeoutDeferralHandle を呼び出してそのハンドルを閉じる必要があります。複数の画面タイムアウトの延期ハンドルを取得することができ、すべての画面タイムアウトの延期ハンドルが閉じられた後にのみ、ゲームで画面タイムアウトが有効になります。
タイトルがアクティブにデバッグされている間は、画面の減光は行われません。
次の例では、XDisplayAcquireTimeoutDeferral を呼び出して新しい画面タイムアウトの延期ハンドルを取得した後、長い導入カットシーンを再生します。新しいハンドルが正常に取得された場合、ユーザーの非操作による画面タイムアウトなしで長い導入カットシーンを再生できます。カットシーンの再生が完了したら、この例は XDisplayCloseTimeoutDeferralHandle を呼び出してハンドルを閉じます。すべての画面タイムアウトの延期ハンドルが閉じられた後は、ユーザーの非操作による画面タイムアウトが再び発生する可能性があります。

Requirements

ヘッダー: XDisplay.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

See also

XDisplayCloseTimeoutDeferralHandle
XDisplay
最終更新日 2026年8月24日