DXGKARGCB_NOTIFY_INTERRUPT_DATA構造体 (d3dkmddi.h)

[アーティクル]
11/08/2024

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

InterruptType が DXGK_INTERRUPT_DMA_COMPLETEDされるときに使用される構造体。

DmaCompleted.SubmissionFenceId

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

DmaCompleted.NodeOrdinal

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

DmaCompleted.EngineOrdinal

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

DmaPreempted

InterruptType が DXGK_INTERRUPT_DMA_PREEMPTEDされるときに使用される構造体。

DmaPreempted.PreemptionFenceId

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

DmaPreempted.LastCompletedFenceId

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

DmaPreempted.NodeOrdinal

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

DmaPreempted.EngineOrdinal

DmaFaulted

InterruptType が DXGK_INTERRUPT_DMA_FAULTEDされるときに使用される構造体。

DmaFaulted.FaultedFenceId

障害のあるコマンドの識別子。

DmaFaulted.Status

障害のあるコマンドの状態。

DmaFaulted.NodeOrdinal

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

DmaFaulted.EngineOrdinal

CrtcVsync

InterruptType が DXGK_INTERRUPT_CRTC_VSYNCされるときに使用される構造体。

CrtcVsync.VidPnTargetId

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

CrtcVsync.PhysicalAddress

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

CrtcVsync.PhysicalAdapterMask

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

DisplayOnlyVsync

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

DisplayOnlyVsync.VidPnTargetId

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

CrtcVsyncWithMultiPlaneOverlay

InterruptType が DXGK_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

InterruptType が DXGK_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

InterruptType が DXGK_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。後者の場合は、FaultErrorCode フィールドを使用して GPU エラーを記述する必要があります。 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

InterruptType が DXGK_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

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

MonitoredFenceSignaled.NodeOrdinal

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

MonitoredFenceSignaled.EngineOrdinal

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

HwContextListSwitchCompleted

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

HwContextListSwitchCompleted.NodeOrdinal

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

HwContextListSwitchCompleted.EngineOrdinal

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

HwContextListSwitchCompleted.ContextSwitchFence

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

HwQueuePageFaulted

InterruptType が DXGK_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

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

PeriodicMonitoredFenceSignaled.VidPnTargetId

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

PeriodicMonitoredFenceSignaled.NotificationID

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

SchedulingLogInterrupt

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

SchedulingLogInterrupt.NodeOrdinal

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

SchedulingLogInterrupt.EngineOrdinal

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

GpuEngineTimeout

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

GpuEngineTimeout.NodeOrdinal

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

GpuEngineTimeout.EngineOrdinal

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

SuspendContextCompleted

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

SuspendContextCompleted.hContext

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

SuspendContextCompleted.ContextSuspendFence

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

CrtcVsyncWithMultiPlaneOverlay3

InterruptType が DXGK_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

[in]InterruptType が DXGK_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

[in]InterruptType が DXGK_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)
ヘッダー	d3dkmddi.h (D3dkmddi.h を含む)

次の方法で共有

DXGKARGCB_NOTIFY_INTERRUPT_DATA構造体 (d3dkmddi.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース