DXGKARGCB_NOTIFY_INTERRUPT_DATA 構造体 (d3dkmddi.h)

DXGKARGCB_NOTIFY_INTERRUPT_DATA構造体には、DXGKCB_NOTIFY_INTERRUPTコールバック関数の割り込み通知情報が含まれています。

構文

typedef struct _DXGKARGCB_NOTIFY_INTERRUPT_DATA {
  DXGK_INTERRUPT_TYPE                InterruptType;
  union {
    struct {
      UINT SubmissionFenceId;
      UINT NodeOrdinal;
      UINT EngineOrdinal;
    } DmaCompleted;
    struct {
      UINT PreemptionFenceId;
      UINT LastCompletedFenceId;
      UINT NodeOrdinal;
      UINT EngineOrdinal;
    } DmaPreempted;
    struct {
      UINT     FaultedFenceId;
      NTSTATUS Status;
      UINT     NodeOrdinal;
      UINT     EngineOrdinal;
    } DmaFaulted;
    struct {
      D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId;
      PHYSICAL_ADDRESS               PhysicalAddress;
      UINT                           PhysicalAdapterMask;
    } CrtcVsync;
    struct {
      D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId;
    } DisplayOnlyVsync;
    struct {
      D3DDDI_VIDEO_PRESENT_TARGET_ID     VidPnTargetId;
      UINT                               PhysicalAdapterMask;
      UINT                               MultiPlaneOverlayVsyncInfoCount;
      DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO *pMultiPlaneOverlayVsyncInfo;
    } CrtcVsyncWithMultiPlaneOverlay;
    DXGKARGCB_PRESENT_DISPLAYONLY_PROGRESS DisplayOnlyPresentProgress;
    struct {
      D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId;
      DXGK_MIRACAST_CHUNK_INFO       ChunkInfo;
      PVOID                          pPrivateDriverData;
      UINT                           PrivateDataDriverSize;
      NTSTATUS                       Status;
    } MiracastEncodeChunkCompleted;
    struct {
      UINT                       FaultedFenceId;
      UINT64                     FaultedPrimitiveAPISequenceNumber;
      DXGK_RENDER_PIPELINE_STAGE FaultedPipelineStage;
      UINT                       FaultedBindTableEntry;
      DXGK_PAGE_FAULT_FLAGS      PageFaultFlags;
      D3DGPU_VIRTUAL_ADDRESS     FaultedVirtualAddress;
      UINT                       NodeOrdinal;
      UINT                       EngineOrdinal;
      UINT                       PageTableLevel;
      DXGK_FAULT_ERROR_CODE      FaultErrorCode;
      HANDLE                     FaultedProcessHandle;
    } DmaPageFaulted;
    struct {
      D3DDDI_VIDEO_PRESENT_TARGET_ID      VidPnTargetId;
      UINT                                PhysicalAdapterMask;
      UINT                                MultiPlaneOverlayVsyncInfoCount;
      DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO2 *pMultiPlaneOverlayVsyncInfo;
      ULONGLONG                           GpuFrequency;
      ULONGLONG                           GpuClockCounter;
    } CrtcVsyncWithMultiPlaneOverlay2;
    struct {
      UINT NodeOrdinal;
      UINT EngineOrdinal;
    } MonitoredFenceSignaled;
    struct {
      UINT   NodeOrdinal;
      UINT   EngineOrdinal;
      UINT64 ContextSwitchFence;
    } HwContextListSwitchCompleted;
    struct {
      UINT64                     FaultedFenceId;
      D3DGPU_VIRTUAL_ADDRESS     FaultedVirtualAddress;
      UINT64                     FaultedPrimitiveAPISequenceNumber;
      union {
        HANDLE FaultedHwQueue;
        HANDLE FaultedHwContext;
        HANDLE FaultedProcessHandle;
      };
      UINT                       NodeOrdinal;
      UINT                       EngineOrdinal;
      DXGK_RENDER_PIPELINE_STAGE FaultedPipelineStage;
      UINT                       FaultedBindTableEntry;
      DXGK_PAGE_FAULT_FLAGS      PageFaultFlags;
      UINT                       PageTableLevel;
      DXGK_FAULT_ERROR_CODE      FaultErrorCode;
    } HwQueuePageFaulted;
    struct {
      D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId;
      UINT                           NotificationID;
    } PeriodicMonitoredFenceSignaled;
    struct {
      UINT NodeOrdinal;
      UINT EngineOrdinal;
    } SchedulingLogInterrupt;
    struct {
      UINT NodeOrdinal;
      UINT EngineOrdinal;
    } GpuEngineTimeout;
    struct {
      HANDLE hContext;
      UINT64 ContextSuspendFence;
    } SuspendContextCompleted;
    struct {
      D3DDDI_VIDEO_PRESENT_TARGET_ID      VidPnTargetId;
      UINT                                PhysicalAdapterMask;
      UINT                                MultiPlaneOverlayVsyncInfoCount;
      DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO3 *pMultiPlaneOverlayVsyncInfo;
      ULONGLONG                           GpuFrequency;
      ULONGLONG                           GpuClockCounter;
    } CrtcVsyncWithMultiPlaneOverlay3;
    struct {
      UINT   NodeOrdinal;
      UINT   EngineOrdinal;
      UINT   SignaledNativeFenceCount;
      HANDLE *pSignaledNativeFenceArray;
      HANDLE hHWQueue;
    } NativeFenceSignaled;
    struct {
      UINT              NodeOrdinal;
      UINT              EngineOrdinal;
      DXGK_ENGINE_STATE NewState;
    } EngineStateChange;
    struct {
      UINT Reserved[16];
    } Reserved;
  };
  DXGKCB_NOTIFY_INTERRUPT_DATA_FLAGS Flags;
} DXGKARGCB_NOTIFY_INTERRUPT_DATA;

メンバー

InterruptType

ディスプレイ ミニポート ドライバーが GPU スケジューラに通知する割り込みの種類を示すDXGK_INTERRUPT_TYPE型指定された値。

DmaCompleted

InterruptTypeDXGK_INTERRUPT_DMA_COMPLETEDされるときに使用される構造体。

DmaCompleted.SubmissionFenceId

完了したコマンドの DMA バッファー フェンス識別子。 この識別子は、ドライバーの DXGKDDI_SUBMITCOMMAND 関数の呼び出し中に、完了した最新の DMA バッファーに割り当てられます。

DmaCompleted.NodeOrdinal

通知を生成するノードの 0 から始まるインデックス。

DmaCompleted.EngineOrdinal

NodeOrdinal が指定するノード内で通知を生成するエンジンの 0 から始まるインデックス。 リンクに含まれていないグラフィックス アダプターの場合は、常に EngineOrdinal を 0 に設定する必要があります。 リンクの一部であるグラフィックス アダプターの場合は、 EngineOrdinal を、割り込みエンジンが属するリンク内のアダプターのアダプター インデックスに設定します。

DmaPreempted

InterruptTypeDXGK_INTERRUPT_DMA_PREEMPTEDされるときに使用される構造体。

DmaPreempted.PreemptionFenceId

割り込み要求の送信識別子。

DmaPreempted.LastCompletedFenceId

プリエンプション前の最後に完了したコマンドの送信識別子。

DmaPreempted.NodeOrdinal

通知を生成するノードの 0 から始まるインデックス。

DmaPreempted.EngineOrdinal

NodeOrdinal が指定するノード内で通知を生成するエンジンの 0 から始まるインデックス。 リンクの一部ではないグラフィックス アダプターの場合は、 常に EngineOrdinal を 0 に設定する必要があります。 リンクの一部であるグラフィックス アダプターの場合は、 EngineOrdinal を、割り込みエンジンが属するリンク内のアダプターのアダプター インデックスに設定します。 GPU スケジューラは、プリエンプション要求と LastCompletedFenceId が指定する送信の間に、ハードウェアがすべてのコマンドを割り込んだと判断します。

DmaFaulted

InterruptTypeDXGK_INTERRUPT_DMA_FAULTEDされるときに使用される構造体。

DmaFaulted.FaultedFenceId

問題のあるコマンドの識別子。

DmaFaulted.Status

問題のあるコマンドの状態。

DmaFaulted.NodeOrdinal

通知を生成するノードの 0 から始まるインデックス。

DmaFaulted.EngineOrdinal

NodeOrdinal が指定するノード内で通知を生成するエンジンの 0 から始まるインデックス。 リンクに含まれていないグラフィックス アダプターの場合は、常に EngineOrdinal を 0 に設定する必要があります。 リンクの一部であるグラフィックス アダプターの場合は、 EngineOrdinal を、割り込みエンジンが属するリンク内のアダプターのアダプター インデックスに設定します。

CrtcVsync

InterruptTypeDXGK_INTERRUPT_CRTC_VSYNCされるときに使用される構造体。

CrtcVsync.VidPnTargetId

ビデオ 提示ネットワーク (VidPN) トポロジのパス内にあるビデオ存在ターゲットの 0 から始まる識別番号。 この数値は、垂直方向の同期が行われるビデオの現在のターゲットを表します。

CrtcVsync.PhysicalAddress

表示バッファーの物理アドレス。 モニターの可視性がオフの場合でも、オペレーティング システムでは NULL 以外の物理アドレスが想定されます。 このアドレスは、可視性がオンの場合にピクセル パイプラインが読み取る物理アドレスに設定する必要があります。

CrtcVsync.PhysicalAdapterMask

垂直同期が行われる物理アダプター マスク。 このメンバーに有効な値が含まれている場合、ドライバーは Flags メンバーの ValidPhysicalAdapterMask ビット フィールド フラグも設定する必要があります。

DisplayOnlyVsync

InterruptTypeDXGK_INTERRUPT_DISPLAYONLY_VSYNCされるときに使用される構造体。 Windows 8 以降でサポートされています。

DisplayOnlyVsync.VidPnTargetId

表示専用ドライバーの場合、ビデオ 存在ネットワーク (VidPN) トポロジのパス内のビデオ存在ターゲットの 0 から始まる識別番号。 この数値は、垂直方向の同期が行われるビデオの現在のターゲットを表します。 Windows 8 以降でサポートされています。

CrtcVsyncWithMultiPlaneOverlay

InterruptTypeDXGK_INTERRUPT_CRTC_VSYNC_WITH_MULTIPLANE_OVERLAYされるときに使用される構造体。 マルチプレーン オーバーレイをサポートするディスプレイ ミニポート ドライバーの VSync 通知を提供します。 Windows 8 以降でサポートされています。

CrtcVsyncWithMultiPlaneOverlay.VidPnTargetId

ビデオ 提示ネットワーク (VidPN) トポロジのパス内にあるビデオ存在ターゲットの 0 から始まる識別番号。 この数値は、垂直方向の同期が行われるビデオの現在のターゲットを表します。 Windows 8 以降でサポートされています。

CrtcVsyncWithMultiPlaneOverlay.PhysicalAdapterMask

垂直同期が行われる物理アダプター マスク。 このメンバーに有効な値が含まれている場合、ドライバーは Flags メンバーの ValidPhysicalAdapterMask ビット フィールド フラグも設定する必要があります。 Windows 8 以降でサポートされています。

CrtcVsyncWithMultiPlaneOverlay.MultiPlaneOverlayVsyncInfoCount

表示できるオーバーレイ平面の数。 Windows 8 以降でサポートされています。

CrtcVsyncWithMultiPlaneOverlay.pMultiPlaneOverlayVsyncInfo

VSync 間隔中に表示するオーバーレイ プレーンを指定する DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO 構造体へのポインター。 Windows 8 以降でサポートされています。

DisplayOnlyPresentProgress

カーネル モードの表示専用ドライバー (KMDOD) の現在の操作の進行状況を提供する DXGKARGCB_PRESENT_DISPLAYONLY_PROGRESS 構造体。 InterruptType がDXGK_INTERRUPT_DISPLAYONLY_PRESENT_PROGRESSされるときに使用されます。 Windows 8 以降でサポートされています。

MiracastEncodeChunkCompleted

InterruptTypeDXGK_INTERRUPT_MICACAST_CHUNK_PROCESSING_COMPLETEされるときに使用される構造体。 WDDM 1.3 以降でサポートされているディスプレイ ミニポート ドライバーは、Windows 8.1 以降で実行されています。

MiracastEncodeChunkCompleted.VidPnTargetId

ビデオ 提示ネットワーク (VidPN) トポロジのパス内にあるビデオ存在ターゲットの 0 から始まる識別番号。 この数値は、エンコードが実行されているビデオの現在のターゲットを表します。 Windows 8.1 以降でサポートされています。

MiracastEncodeChunkCompleted.ChunkInfo

DXGK_MIRACAST_CHUNK_INFOディスプレイ ミニポート ドライバーが報告するチャンク情報構造をエンコードします。 Windows 8.1 以降でサポートされています。

MiracastEncodeChunkCompleted.pPrivateDriverData

このエンコード チャンクを記述するプライベート データのブロックへのポインター。 Windows 8.1 以降でサポートされています。

MiracastEncodeChunkCompleted.PrivateDataDriverSize

pPrivateDriverData 内のプライベート データのブロックのサイズ (バイト単位)。 この値は、ドライバーがDXGK_MIRACAST_CAPS構造体で報告した MaxChunkPrivateDriverDataSize 値より大きくすることはできません。 Windows 8.1 以降でサポートされています。

MiracastEncodeChunkCompleted.Status

エンコード チャンクがチャンクのキューに正常に追加されたかどうかを示す NTSTATUS 型の値。 成功した場合は、 STATUS_SUCCESS が返されます。 他の値が返された場合、チャンクをキューに追加できず、未処理のチャンクはすべて失われます。 Windows 8.1 以降でサポートされています。

意味
STATUS_SUCCESS チャンクがキューに正常に追加されました。
STATUS_INVALID_PARAMETER パラメーターが検証され、正しくないと判断されました。
STATUS_NO_MEMORY 割り込みサービス ルーチン (ISR) で、空きエンコード チャンクが不足しました。

DmaPageFaulted

InterruptTypeDXGK_INTERRUPT_DMA_PAGE_FAULTEDされるときに使用される構造体。 Windows 10 以降でサポートされています。

DmaPageFaulted.FaultedFenceId

エラーが発生したコマンドの送信フェンス ID。

障害が発生したフェンスを確実に特定できない場合は、 PageFaultFlagsにDXGK_PAGE_FAULT_FENCE_INVALID ビットが設定されている必要があり、 FaultedFenceId を 0 に設定する必要があります。 Windows 10 以降でサポートされています。

DmaPageFaulted.FaultedPrimitiveAPISequenceNumber

描画フェンスごとの書き込みが有効になっている場合は、ページ フォールトの原因となった描画操作が識別されます。または、そのような情報が利用できない場合は DXGK_PRIMITIVE_API_SEQUENCE_NUMBER_UNKNOWN 。 Windows 10 以降でサポートされています。

DmaPageFaulted.FaultedPipelineStage

エラーが生成されたパイプライン ステージをレンダリングするか、そのような情報が利用できない場合は DXGK_RENDER_PIPELINE_STAGE_UNKNOWN します。 Windows 10 以降でサポートされています。

DmaPageFaulted.FaultedBindTableEntry

障害発生時にアクセスされるリソースのバインド テーブル インデックス。そのような情報が利用できない場合は DXGK_BIND_TABLE_ENTRY_UNKNOWN 。 Windows 10 以降でサポートされています。

DmaPageFaulted.PageFaultFlags

エラーの性質 を指定DXGK_PAGE_FAULT_FLAGS 列挙で説明されているフラグ。 Windows 10 以降でサポートされています。

DmaPageFaulted.FaultedVirtualAddress

障害の GPU 仮想アドレス。または、障害に別の原因がある場合は D3DGPU_NULL 。 後者の場合は、GPU エラーを説明するために FaultErrorCode フィールドを使用する必要があります。 Windows 10 以降でサポートされています。

DmaPageFaulted.NodeOrdinal

通知を生成するエンジンのノード序数。 Windows 10 以降でサポートされています。

DmaPageFaulted.EngineOrdinal

通知を生成するエンジンのエンジン序数。 Windows 10 以降でサポートされています。

DmaPageFaulted.PageTableLevel

エラーが発生した操作が試行されたページ テーブル レベルについて説明します。 Windows 10 以降でサポートされています。

DmaPageFaulted.FaultErrorCode

エラーを記述する DXGK_FAULT_ERROR_CODE 構造体。 Windows 10 以降でサポートされています。

DmaPageFaulted.FaultedProcessHandle

ページ フォールトを生成したプロセスの DirectX グラフィックス カーネル プロセス ハンドル。エラーが発生したプロセスを特定できない場合は NULL 。 Windows 10 以降でサポートされています。

CrtcVsyncWithMultiPlaneOverlay2

InterruptTypeDXGK_INTERRUPT_CRTC_VSYNC_WITH_MULTIPLANE_OVERLAY2されるときに使用される構造体。 Windows 10 バージョン 1607 以降でサポートされています。

CrtcVsyncWithMultiPlaneOverlay2.VidPnTargetId

マルチプレーン オーバーレイ Vidpn ターゲット ID を持つ Vsync。Windows 10 バージョン 1607 以降でサポートされています。

CrtcVsyncWithMultiPlaneOverlay2.PhysicalAdapterMask

垂直同期が行われる物理アダプター マスク。 このメンバーに有効な値が含まれている場合、ドライバーは Flags メンバーの ValidPhysicalAdapterMask ビット フィールド フラグも設定する必要があります。 Windows 10 バージョン 1607 以降でサポートされています。

CrtcVsyncWithMultiPlaneOverlay2.MultiPlaneOverlayVsyncInfoCount

表示できるオーバーレイ 平面の数。 Windows 10 バージョン 1607 以降でサポートされています。

CrtcVsyncWithMultiPlaneOverlay2.pMultiPlaneOverlayVsyncInfo

VSync によって更新された各オーバーレイ プレーンの情報を指定する DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO2 構造体へのポインター。 Windows 10 バージョン 1607 以降でサポートされています。

CrtcVsyncWithMultiPlaneOverlay2.GpuFrequency

GPU クロック カウンターの周波数。 Windows 10 バージョン 1607 以降でサポートされています。

CrtcVsyncWithMultiPlaneOverlay2.GpuClockCounter

VSYNC 割り込み時の GPU クロック カウンター。 GpuFrequency と組み合わせると、VSYNC 割り込みの時間が示されます。 Windows 10 バージョン 1607 以降でサポートされています。

MonitoredFenceSignaled

InterruptTypeDXGK_INTERRUPT_MONITORED_FENCE_SIGNALEDされるときに使用される構造体。 Windows 10 バージョン 1703 以降でサポートされています。

MonitoredFenceSignaled.NodeOrdinal

通知を生成するエンジンのノード序数。 Windows 10 バージョン 1703 以降でサポートされています。

MonitoredFenceSignaled.EngineOrdinal

通知を生成するエンジンのエンジン序数。 Windows 10 バージョン 1703 以降でサポートされています。

HwContextListSwitchCompleted

InterruptTypeDXGK_INTERRUPT_HWCONTEXTLIST_SWITCH_COMPLETEDされるときに使用される構造体。 Windows 10 バージョン 1703 以降でサポートされています。

HwContextListSwitchCompleted.NodeOrdinal

通知を生成するエンジンのノード序数。 Windows 10 バージョン 1703 以降でサポートされています。

HwContextListSwitchCompleted.EngineOrdinal

通知を生成するエンジンのエンジン序数。 Windows 10 バージョン 1703 以降でサポートされています。

HwContextListSwitchCompleted.ContextSwitchFence

この切り替え操作の実行に使用されるコンテキスト スイッチ フェンス。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted

InterruptTypeDXGK_INTERRUPT_HWQUEUE_PAGE_FAULTEDされるときに使用される構造体。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted.FaultedFenceId

障害が発生したコマンドの HW キュー進行状況フェンス ID。 障害が発生したフェンスを確実に判断できない場合は、PageFaultFlags に DXGK_PAGE_FAULT_FENCE_INVALID フラグを設定する必要があります。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted.FaultedVirtualAddress

障害の仮想アドレス。障害に別の原因がある場合は 0。 後者の場合は、GPU エラーを記述するために FaultErrorCode フィールドを使用する必要があります。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted.FaultedPrimitiveAPISequenceNumber

描画フェンスごとの書き込みが有効になっている場合は、ページ フォールトの原因となった描画を識別するか、そのような情報が使用できない場合はDXGK_PRIMITIVE_API_SEQUENCE_NUMBER_UNKNOWNします。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted.FaultedHwQueue

DXGK_PAGE_FAULT_FENCE_INVALIDが設定されていない場合は、障害を生成した HW キューのハンドルを指定します。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted.FaultedHwContext

DXGK_PAGE_FAULT_FENCE_INVALIDとDXGK_PAGE_FAULT_HW_CONTEXT_VALIDが設定されている場合は、障害を生成した HW コンテキストのハンドルを指定します。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted.FaultedProcessHandle

Wen DXGK_PAGE_FAULT_FENCE_INVALID と DXGK_PAGE_FAULT_PROCESS_HANDLE_VALID が設定され、エラーを生成したプロセスのハンドルを指定します。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted.NodeOrdinal

通知を生成するエンジンのノード序数。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted.EngineOrdinal

通知を生成するエンジンのエンジン序数。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted.FaultedPipelineStage

エラーが生成されたパイプライン ステージをレンダリングするか、そのような情報が利用できない場合はDXGK_RENDER_PIPELINE_STAGE_UNKNOWNします。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted.FaultedBindTableEntry

障害発生時にアクセスされるリソースのバインド テーブル インデックス。または、そのような情報が利用できない場合はDXGK_BIND_TABLE_ENTRY_UNKNOWN。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted.PageFaultFlags

ページ フォールトと回復ポリシーの性質を指定するフラグ。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted.PageTableLevel

エラー処理が試行されたページ テーブル レベルについて説明します。 Windows 10 バージョン 1703 以降でサポートされています。

HwQueuePageFaulted.FaultErrorCode

エラーを記述するエラー コードを含む構造体。 Windows 10 バージョン 1703 以降でサポートされています。

PeriodicMonitoredFenceSignaled

InterruptTypeDXGK_INTERRUPT_PERIODIC_MONITORED_FENCE_SIGNALEDされるときに使用される構造体。 Windows 10 バージョン 1703 以降でサポートされています。

PeriodicMonitoredFenceSignaled.VidPnTargetId

監視対象フェンスを通知する表示。 Windows 10 バージョン 1703 以降でサポートされています。

PeriodicMonitoredFenceSignaled.NotificationID

複数の通知 ID を 1 つの VidPnSource にアタッチできます。 Windows 10 バージョン 1703 以降でサポートされています。

SchedulingLogInterrupt

InterruptTypeDXGK_INTERRUPT_SCHEDULING_LOG_INTERRUPTされるときに使用される構造体。 Windows 10 バージョン 1803 以降でサポートされています。

SchedulingLogInterrupt.NodeOrdinal

スケジュール ログ割り込みを発生させたエンジンのノード序数。 Windows 10 バージョン 1803 以降でサポートされています。

SchedulingLogInterrupt.EngineOrdinal

スケジュール ログ割り込みを発生させたエンジンのエンジン序数。 Windows 10 バージョン 1803 以降でサポートされています。

GpuEngineTimeout

InterruptTypeDXGK_INTERRUPT_GPU_ENGINE_TIMEOUTされるときに使用される構造体。 Windows 10 バージョン 1803 以降でサポートされています。

GpuEngineTimeout.NodeOrdinal

タイムアウトし、リセットが必要なエンジンのノード序数。 Windows 10 バージョン 1803 以降でサポートされています。

GpuEngineTimeout.EngineOrdinal

タイムアウトし、リセットが必要なエンジンのエンジン序数。 Windows 10 バージョン 1803 以降でサポートされています。

SuspendContextCompleted

InterruptTypeDXGK_INTERRUPT_SUSPEND_CONTEXT_COMPLETEDされるときに使用される構造体。 Windows 10 バージョン 1803 以降でサポートされています。

SuspendContextCompleted.hContext

中断確認の対象となるハードウェア コンテキスト。 Windows 10 バージョン 1803 以降でサポートされています。

SuspendContextCompleted.ContextSuspendFence

コンテキストはフェンスを中断します。 Windows 10 バージョン 1803 以降でサポートされています。

CrtcVsyncWithMultiPlaneOverlay3

InterruptTypeDXGK_INTERRUPT_CRTC_VSYNC_WITH_MULTIPLANE_OVERLAY3されるときに使用される構造体。 Windows Server 2022 (WDDM 2.9) 以降で使用できます。

CrtcVsyncWithMultiPlaneOverlay3.VidPnTargetId

マルチプレーン オーバーレイ Vidpn ターゲット ID を持つ Vsync。Windows Server 2022 (WDDM 2.9) 以降で使用できます。

CrtcVsyncWithMultiPlaneOverlay3.PhysicalAdapterMask

垂直同期が行われる物理アダプター マスク。 このメンバーに有効な値が含まれている場合、ドライバーは Flags メンバーの ValidPhysicalAdapterMask ビット フィールド フラグも設定する必要があります。 Windows Server 2022 (WDDM 2.9) 以降で使用できます。

CrtcVsyncWithMultiPlaneOverlay3.MultiPlaneOverlayVsyncInfoCount

CrtcVsyncWithMultiPlaneOverlay3.pMultiPlaneOverlayVsyncInfo が指すDXGK_MULTIPLANE_OVERLAY_VSYNC_INFO3構造体の数。 これらの構造体は、表示できるオーバーレイ 平面を表します。 Windows Server 2022 (WDDM 2.9) 以降で使用できます。

CrtcVsyncWithMultiPlaneOverlay3.pMultiPlaneOverlayVsyncInfo

VSync によって更新された各オーバーレイ プレーンの情報を指定する DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO3 構造体の配列へのポインター。 詳細については、「 ハードウェア フリップ キュー 」を参照してください。 Windows Server 2022 (WDDM 2.9) 以降で使用できます。

CrtcVsyncWithMultiPlaneOverlay3.GpuFrequency

GPU クロック カウンターの周波数。 Windows Server 2022 (WDDM 2.9) 以降で使用できます。

CrtcVsyncWithMultiPlaneOverlay3.GpuClockCounter

VSYNC 割り込み時の GPU クロック カウンター。 GpuFrequency と組み合わせると、VSYNC 割り込みの時間が示されます。 Windows Server 2022 (WDDM 2.9) 以降で使用できます。

NativeFenceSignaled

[入力] InterruptTypeDXGK_INTERRUPT_NATIVE_FENCE_SIGNALEDされるときに使用される構造体。 ネイティブ フェンスの詳細については、「 ネイティブ GPU フェンス オブジェクト」を参照してください。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降でサポートされています。

NativeFenceSignaled.NodeOrdinal

通知を生成するエンジンのノード序数。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降でサポートされています。

NativeFenceSignaled.EngineOrdinal

通知を生成するエンジンのエンジン序数。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降でサポートされています。

NativeFenceSignaled.SignaledNativeFenceCount

pSignaledNativeFenceArray が指すシグナルネイティブ フェンス配列のサイズ。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降でサポートされています。

NativeFenceSignaled.pSignaledNativeFenceArray

通知され、ウェイターのブロックを解除する必要があるすべてのネイティブ フェンスの OS カーネル モード ハンドルを含む配列。 この配列が空の場合、OS は、シグナルネイティブ フェンス配列で指定されたサブセットではなく、保留中のすべてのネイティブ フェンス ウェイターを再スキャンします。 Dxgkrnl、DXGK_VIDSCHCAPS::OptimizedNativeFenceInterrupt が FALSE の場合にのみ、この値を読み取ります。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降でサポートされています。

NativeFenceSignaled.hHWQueue

割り込みを発生させたエンジンで実行されている HWQueue の KMD ハンドル。 このハンドルが NULL の場合、 Dxgkrnl はこのエンジン上のすべての HWQueues のログ バッファーを再スキャンします。 Dxgkrnl、DXGK_VIDSCHCAPS::OptimizedNativeFenceInterrupt が TRUE の場合にのみ、この値を読み取ります。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降でサポートされています。

EngineStateChange

[入力] InterruptTypeDXGK_INTERRUPT_GPU_ENGINE_STATE_CHANGEされるときに使用される構造体。 詳細については、「 ユーザー モードの作業の送信」を参照してください。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降で使用できます。

EngineStateChange.NodeOrdinal

状態が変更されたエンジンのノード序数。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降で使用できます。

EngineStateChange.EngineOrdinal

状態が変更されたエンジンのエンジン序数。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降で使用できます。

EngineStateChange.NewState

エンジン の新 しい状態を指定するDXGK_ENGINE_STATE値。 Windows 11 バージョン 24H2 (WDDM 3.2) 以降で使用できます。

Reserved

将来利用するために予約されています。

Reserved.Reserved[16]

将来使用するために予約されている 32 ビット値の配列。

Flags

ディスプレイ ミニポート ドライバーが DxgkCbNotifyInterrupt 関数の呼び出しで物理アダプター マスクを提供するかどうかを示すDXGKCB_NOTIFY_INTERRUPT_DATA_FLAGS構造体。

注釈

ミニポート ドライバーは 、DXGKARGCB_NOTIFY_INTERRUPT_DATAを入力し、割り込みと同期する DXGKCB_SYNCHRONIZE_EXECUTION コールバックを使用します。 DXGKCB_SYNCHRONIZE_EXECUTION コールバックの SynchronizeRoutine パラメーターは、必要に応じて OS によって呼び出されるミニポート実装関数を指し、ドライバーはパラメーター情報を入力してから、DXGKCB_NOTIFY_INTERRUPT コールバックを使用して OS にコールバックします。 その後、OS は割り込みを処理し、スケジューラは DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO2 構造体の情報を使用します。

InterruptType メンバーの値に応じて、ディスプレイ ミニポート ドライバーは、この構造体の適切な共用体メンバーを設定する必要があります。 たとえば、InterruptType の DXGK_INTERRUPT_DMA_COMPLETED の値に対応するダイレクト メモリ アクセス (DMA) バッファー フェンスの末尾では、ドライバーは DmaCompleted メンバーの SubmissionFenceId メンバーに値を設定する必要があります。 この値は、ドライバーの DxgkDdiSubmitCommand 関数が完了したばかりの DMA バッファーに割り当てられる DMA バッファー フェンス識別子である必要があります。

要件

要件
サポートされている最小のクライアント Windows Vista (WDDM 1.0)
Header d3dkmddi.h (D3dkmddi.h を含む)

こちらもご覧ください

DXGK_INTERRUPT_TYPE

DXGK_MIRACAST_CAPS

DXGK_MIRACAST_CHUNK_INFO

DXGK_MULTIPLANE_OVERLAY_VSYNC_INFO

DXGKCB_NOTIFY_INTERRUPT

DXGKCB_NOTIFY_INTERRUPT_DATA_FLAGS

DXGK_PAGE_FAULT_FLAGS

DXGKARGCB_PRESENT_DISPLAYONLY_PROGRESS

DxgkDdiSubmitCommand