estructura DXGKARG_CANCELCOMMAND (d3dkmddi.h)

Artículo
03/08/2023

Especifica los recursos internos que limpia la función DxgkDdiCancelCommand después de quitar un comando de la cola de hardware.

Sintaxis

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;

Miembros

[in] hContext

Si el controlador es compatible con varios motores (es decir, el controlador admite la creación de contexto), un identificador para el contexto del dispositivo desde el que se originó la solicitud de cancelación.

Para algunas operaciones de paginación, hContext es NULL (por ejemplo, operaciones de paginación que expulsan el contenido de todo el búfer de fotogramas durante la administración de energía). Las operaciones de paginación se indican mediante la marca de campo de bits de paginación en el miembro Flags .

[out] pDmaBuffer

Puntero al inicio del búfer de DMA, que se alinea en 4 KB.

[in] DmaBufferSize

Tamaño, en bytes, del búfer DMA al que apunta pDmaBuffer .

[in] DmaBufferSubmissionStartOffset

Desplazamiento, en bytes, desde el principio del búfer DMA que pDmaBuffer especifica para el inicio de la parte del búfer DMA que requiere la cancelación. El desplazamiento que se recibe en el momento de la revisión coincide con el desplazamiento que se recibe en el momento del envío.

[in] DmaBufferSubmissionEndOffset

Desplazamiento, en bytes, desde el principio del búfer DMA que pDmaBuffer especifica al final de la parte del búfer DMA que requiere cancelar.

[in] pDmaBufferPrivateData

Puntero a los datos privados residentes en el controlador que está asociado al búfer DMA al que apunta pDmaBuffer .

[in] DmaBufferPrivateDataSize

Tamaño, en bytes, de los datos del controlador privado en pDmaBufferPrivateData.

Tenga en cuenta que DmaBufferPrivateDataSize representa toda la longitud del búfer de datos del controlador privado; sin embargo, la parte asociada a la solicitud de cancelación actual podría ser menor.

[in] DmaBufferPrivateDataSubmissionStartOffset

Desplazamiento, en bytes, desde el principio de los datos privados del búfer DMA que pDmaBufferPrivateData especifica para el inicio de la parte de los datos privados asociados a la solicitud de cancelación actual.

[in] DmaBufferPrivateDataSubmissionEndOffset

Desplazamiento, en bytes, desde el principio de los datos privados del búfer DMA que pDmaBufferPrivateData especifica al final de la parte de los datos privados asociados a la solicitud de cancelación actual.

[in] pAllocationList

Puntero a una matriz de estructuras de DXGK_ALLOCATIONLIST para la lista de asignaciones asociadas al búfer DMA al que apunta pDmaBuffer .

[in] AllocationListSize

Número de elementos de la matriz que pAllocationList especifica.

Tenga en cuenta que AllocationListSize representa el tamaño total de la lista de asignación; sin embargo, la parte de la lista de asignación asociada a la solicitud de cancelación actual podría ser menor.

[in] pPatchLocationList

Puntero a una matriz de estructuras de D3DDDI_PATCHLOCATIONLIST para la lista de ubicaciones de revisión asociadas al búfer DMA al que apunta pDmaBuffer .

Tenga en cuenta que la matriz puede comenzar con un elemento que se encuentra antes del intervalo que se usa para aplicar revisiones al búfer DMA.

[in] PatchLocationListSize

Número de elementos de la matriz que pPatchLocationList especifica.

Tenga en cuenta que PatchLocationListSize representa el tamaño total de la lista de ubicación de revisión; sin embargo, el intervalo que el controlador debe procesar suele ser menor.

[in] PatchLocationListSubmissionStart

Índice del primer elemento de la lista patch-location que pPatchLocationList especifica que se debe procesar.

[in] PatchLocationListSubmissionLength

El número de elementos de la lista de ubicación de revisión que pPatchLocationList especifica que se debe procesar.

DmaBufferVirtualAddress

DmaBufferUmdPrivateDataSize