DXGKARG_CANCELCOMMAND構造体 (d3dkmddi.h)

[アーティクル]
02/06/2025

コマンドがハードウェアキューから削除された後、DxgkDdiCancelCommand 関数によってクリーンアップされる内部リソースを指定します。

構文

typedef struct _DXGKARG_CANCELCOMMAND {
  [in]  HANDLE                         hContext;
  [out] VOID                           *pDmaBuffer;
  [in]  UINT                           DmaBufferSize;
  [in]  UINT                           DmaBufferSubmissionStartOffset;
  [in]  UINT                           DmaBufferSubmissionEndOffset;
  [in]  VOID                           *pDmaBufferPrivateData;
  [in]  UINT                           DmaBufferPrivateDataSize;
  [in]  UINT                           DmaBufferPrivateDataSubmissionStartOffset;
  [in]  UINT                           DmaBufferPrivateDataSubmissionEndOffset;
  [in]  const DXGK_ALLOCATIONLIST      *pAllocationList;
  [in]  UINT                           AllocationListSize;
  [in]  const D3DDDI_PATCHLOCATIONLIST *pPatchLocationList;
  [in]  UINT                           PatchLocationListSize;
  [in]  UINT                           PatchLocationListSubmissionStart;
  [in]  UINT                           PatchLocationListSubmissionLength;
        D3DGPU_VIRTUAL_ADDRESS         DmaBufferVirtualAddress;
        UINT                           DmaBufferUmdPrivateDataSize;
} DXGKARG_CANCELCOMMAND;

メンバーズ

[in] hContext

ドライバーが複数エンジンに対応している場合 (つまり、ドライバーはコンテキストの作成をサポートしています)、キャンセル要求が発生したデバイスコンテキストへのハンドル。

ページング操作によっては、hContext は NULL されます (たとえば、電源管理中にフレームバッファー全体のコンテンツを削除するページング操作)。ページング操作は、Flags メンバーの ページング ビットフィールドフラグによって示されます。

[out] pDmaBuffer

DMA バッファーの先頭へのポインター。4 KB にアラインされています。

[in] DmaBufferSize

pDmaBuffer が指 DMA バッファーのサイズ (バイト単位)。

[in] DmaBufferSubmissionStartOffset

pDmaBuffer を DMA バッファーの先頭から、取り消しを必要とする DMA バッファーの部分の先頭までのオフセット (バイト単位)。パッチ時に受信されるオフセットは、送信時に受信されるオフセットと一致します。

[in] DmaBufferSubmissionEndOffset

pDmaBuffer 指定する DMA バッファーの先頭から、取り消しを必要とする DMA バッファーの部分の末尾までのオフセット (バイト単位)。

[in] pDmaBufferPrivateData

pDmaBuffer が指す DMA バッファーに関連付けられているドライバー常駐のプライベートデータへのポインター。

[in] DmaBufferPrivateDataSize

pDmaBufferPrivateData のプライベートドライバーデータサイズ (バイト単位)。

DmaBufferPrivateDataSize は、プライベートドライバーデータバッファーの長さ全体を表します。ただし、現在のキャンセル要求に関連付けられている部分は小さい場合があります。

[in] DmaBufferPrivateDataSubmissionStartOffset

pDmaBufferPrivateData が指定 DMA バッファープライベートデータの先頭から、現在のキャンセル要求に関連付けられているプライベートデータの部分の先頭までのオフセット (バイト単位)。

[in] DmaBufferPrivateDataSubmissionEndOffset

pDmaBufferPrivateData DMA バッファープライベートデータの先頭から現在のキャンセル要求に関連付けられているプライベートデータの部分の末尾までのオフセット (バイト単位)。

[in] pAllocationList

pDmaBuffer が指 DMA バッファーに関連付けられている割り当ての一覧の DXGK_ALLOCATIONLIST 構造体の配列へのポインター。

[in] AllocationListSize

pAllocationList が指定 配列内の要素の数。

AllocationListSize は、割り当てリストの合計サイズを表します。ただし、現在のキャンセル要求に関連付けられている割り当てリストの部分が小さい場合があります。

[in] pPatchLocationList

pDmaBuffer が指す DMA バッファーに関連付けられているパッチの場所の一覧のD3DDDI_PATCHLOCATIONLIST 構造体の配列へのポインター。

配列は、DMA バッファーにパッチを適用するために使用される範囲の前にある要素で始まる可能性があることに注意してください。

[in] PatchLocationListSize

pPatchLocationList が指定 配列内の要素の数。

patchLocationListSize は、パッチの場所リストの合計サイズを表します。ただし、通常、ドライバーが処理する必要がある範囲は小さくなります。

[in] PatchLocationListSubmissionStart

pPatchLocationList が処理する必要があることを指定、パッチの場所リスト内の最初の要素のインデックス。

[in] PatchLocationListSubmissionLength

pPatchLocationList が処理する必要があることを指定 パッチの場所リスト内の要素の数。

DmaBufferVirtualAddress

DmaBufferUmdPrivateDataSize

必要条件

要件	価値
サポートされる最小クライアント	Windows 8
サポートされる最小サーバー	Windows Server 2012
ヘッダー	d3dkmddi.h

次の方法で共有

DXGKARG_CANCELCOMMAND構造体 (d3dkmddi.h)

構文

メンバーズ

必要条件

関連項目

フィードバック

その他のリソース