DXGKARG_CANCELCOMMAND struttura (d3dkmddi.h)

Articolo
08/07/2023

Specifica le risorse interne eliminate dalla funzione DxgkDdiCancelCommand dopo la rimozione di un comando dalla coda hardware.

Sintassi

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;

Members

[in] hContext

Se il driver è a conoscenza di più motori, ovvero il driver supporta la creazione del contesto, un handle per il contesto del dispositivo da cui ha origine la richiesta di annullamento.

Per alcune operazioni di paging , hContext è NULL (ad esempio, le operazioni di paging che estraono il contenuto dell'intero buffer di frame durante la gestione energia). Le operazioni di paging sono indicate dal flag di campo a bit di paging nel membro Flags .

[out] pDmaBuffer

Puntatore all'inizio del buffer DMA, allineato a 4 KB.

[in] DmaBufferSize

Dimensioni, in byte, del buffer DMA a cui pDmaBuffer punta.

[in] DmaBufferSubmissionStartOffset

L'offset, in byte, dall'inizio del buffer DMA che pDmaBuffer specifica all'inizio della parte del buffer DMA che richiede l'annullamento. L'offset ricevuto al momento della patch corrisponde all'offset ricevuto al momento dell'invio.

[in] DmaBufferSubmissionEndOffset

L'offset, in byte, dall'inizio del buffer DMA che pDmaBuffer specifica alla fine della parte del buffer DMA che richiede l'annullamento.

[in] pDmaBufferPrivateData

Puntatore ai dati privati residenti dal driver associati al buffer DMA a cui pDmaBuffer punta.

[in] DmaBufferPrivateDataSize

Dimensioni, in byte, dei dati del driver privato in pDmaBufferPrivateData.

Si noti che DmaBufferPrivateDataSize rappresenta l'intera lunghezza del buffer di dati del driver privato; Tuttavia, la parte associata alla richiesta di annullamento corrente potrebbe essere più piccola.

[in] DmaBufferPrivateDataSubmissionStartOffset

L'offset, in byte, dall'inizio dei dati privati del buffer DMA che pDmaBufferPrivateData specifica all'inizio della parte dei dati privati associati alla richiesta di annullamento corrente.

[in] DmaBufferPrivateDataSubmissionEndOffset

L'offset, in byte, dall'inizio dei dati privati del buffer DMA che pDmaBufferPrivateData specifica alla fine della parte dei dati privati associati alla richiesta di annullamento corrente.

[in] pAllocationList

Puntatore a una matrice di strutture DXGK_ALLOCATIONLIST per l'elenco di allocazioni associate al buffer DMA a cui pDmaBuffer punta.

[in] AllocationListSize

Numero di elementi nella matrice specificata da pAllocationList .

Si noti che AllocationListSize rappresenta la dimensione totale dell'elenco di allocazione; tuttavia, la parte dell'elenco di allocazione associata alla richiesta di annullamento corrente potrebbe essere più piccola.

[in] pPatchLocationList

Puntatore a una matrice di strutture D3DDDI_PATCHLOCATIONLIST per l'elenco delle posizioni delle patch associate al buffer DMA a cui pDmaBuffer punta.

Si noti che la matrice può iniziare con un elemento che è prima dell'intervallo usato per applicare patch al buffer DMA.

[in] PatchLocationListSize

Numero di elementi nella matrice specificata da pPatchLocationList .

Si noti che PatchLocationListSize rappresenta la dimensione totale dell'elenco patch-location; tuttavia, l'intervallo che il driver deve elaborare è in genere più piccolo.

[in] PatchLocationListSubmissionStart

Indice del primo elemento nell'elenco patch-location specificato da pPatchLocationList .

[in] PatchLocationListSubmissionLength

Il numero di elementi nell'elenco patch-location specificato da pPatchLocationList deve essere elaborato.

DmaBufferVirtualAddress

DmaBufferUmdPrivateDataSize