struttura DXGKARG_CANCELCOMMAND (d3dkmddi.h)

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;

Membri

[in] hContext

Se il driver è compatibile con più motori (ovvero il driver supporta la creazione del contesto), un handle per il contesto di dispositivo da cui ha avuto origine la richiesta di annullamento.

Per alcune operazioni di paging, hContext è NULL, ad esempio le operazioni di paging che eliminano il contenuto dell'intero buffer di frame durante il risparmio energia. Le operazioni di paging sono indicate dal flag paging campo di bit nel membro flag flag.

[out] pDmaBuffer

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

[in] DmaBufferSize

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

[in] DmaBufferSubmissionStartOffset

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 in fase di patch corrisponde all'offset ricevuto al momento dell'invio.

[in] DmaBufferSubmissionEndOffset

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

[in] pDmaBufferPrivateData

Puntatore ai dati privati residenti nel 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

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

[in] DmaBufferPrivateDataSubmissionEndOffset

Offset, in byte, dall'inizio dei dati privati del buffer DMA che pDmaBufferPrivateData specifica fino 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 che pAllocationList.

Si noti che AllocationListSize rappresenta le dimensioni totali dell'elenco di allocazioni; Tuttavia, la parte dell'elenco di allocazioni associata alla richiesta di annullamento corrente potrebbe essere inferiore.

[in] pPatchLocationList

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

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

[in] PatchLocationListSize

Numero di elementi nella matrice che pPatchLocationList.

Si noti che patchLocationListSize rappresenta le dimensioni totali dell'elenco di posizioni patch; Tuttavia, l'intervallo che il driver deve elaborare è in genere più piccolo.

[in] PatchLocationListSubmissionStart

Indice del primo elemento nell'elenco patch-location che pPatchLocationList specifica che deve essere elaborato.

[in] PatchLocationListSubmissionLength

Numero di elementi nell'elenco di percorsi patch che pPatchLocationList specifica che devono essere elaborati.

DmaBufferVirtualAddress

DmaBufferUmdPrivateDataSize

Fabbisogno

Vedere anche

D3DDDI_PATCHLOCATIONLIST

DXGK_ALLOCATIONLIST

DxgkDdiCancelCommand

DxgkDdiCreateContext