estructura D3DDDI_ALLOCATIONINFO (d3dukmdt.h)

Artículo
10/25/2023

La estructura de D3DDDI_ALLOCATIONINFO describe una asignación para WDDM v1. En su lugar, los clientes de gráficos en modo de usuario deben usar D3DDDI_ALLOCATIONINFO2 .

Sintaxis

typedef struct _D3DDDI_ALLOCATIONINFO {
  D3DKMT_HANDLE                  hAllocation;
  void                           D3DKMT_PTR(
    const VOID *unnamedParam1,
    pSystemMem unnamedParam2
  );
  void                           D3DKMT_PTR(
    VOID               *unnamedParam1,
    pPrivateDriverData unnamedParam2
  );
  UINT                           PrivateDriverDataSize;
  D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  union {
    struct {
      UINT Primary : 1;
      UINT Stereo : 1;
#if ...
      UINT Reserved : 30;
#else
      UINT Reserved : 31;
#endif
    };
    UINT Value;
  } Flags;
} D3DDDI_ALLOCATIONINFO;

Miembros

hAllocation

[out] Un D3DKMT_HANDLE que representa un identificador en modo kernel para la asignación. Este identificador está asociado al identificador de recursos en modo kernel (si no es NULL) que la función pfnAllocateCb del entorno de ejecución de Direct3D devuelve en el miembro hKMResource de la estructura D3DDDICB_ALLOCATE . El controlador de pantalla en modo de usuario puede usar este identificador de asignación en modo kernel para hacer referencia a la asignación en el búfer de comandos.

void D3DKMT_PTR( const VOID *unnamedParam1, pSystemMem unnamedParam2)

void D3DKMT_PTR( VOID *unnamedParam1, pPrivateDriverData unnamedParam2)

PrivateDriverDataSize

[in] Tamaño en bytes de los datos privados.

VidPnSourceId

[in] Número de identificación de VidPN basado en cero del origen del vídeo presente en una ruta de acceso de una topología de red de vídeo presente (VidPN) si la asignación es para la superficie principal. El controlador debe establecer VidPnSourceId solo para los tipos de asignación principal y no para ningún otro tipo de asignación. Si el controlador establece VidPnSourceId para cualquier otro tipo de asignación en una llamada a la función pfnAllocateCb , pfnAllocateCb devuelve D3DDDI_ID_NOTAPPLICABLE.

Cuando el subsistema del kernel de gráficos de DirectX inicia la creación de la asignación para la superficie principal compartida, el controlador de miniporte de pantalla puede determinar el número de identificación del miembro VidPnSourceId de la estructura D3DKMDDI_SHAREDPRIMARYSURFACEDATA a la que apunta el miembro pPrivateDriverData de la estructura DXGK_ALLOCATIONINFO .

Flags

[in] Unión que contiene una estructura o un valor de 32 bits que identifica el tipo de asignación.

Flags.Primary

[in] UINT que especifica si la asignación forma parte del escritorio. Esta asignación es accesible implícitamente para la CPU. Una asignación principal se puede anclar al crear o no anclarse en la creación.

Establecer este miembro equivale a establecer el primer bit del miembro Value de 32 bits (0x00000001).

Flags.Stereo

[in] Se admite a partir de Windows 8. UINT que especifica si la asignación es una asignación principal estéreo. El miembro estéreo solo se puede establecer cuando se establece el miembro principal .

Establecer este miembro equivale a establecer el segundo bit del miembro Value de 32 bits (0x00000002).

Flags.Reserved

[in] Este miembro está reservado y debe establecerse en cero.

Flags.Value

[in] Valor de 32 bits que identifica el tipo de asignación.

Comentarios

Cuando el controlador de pantalla en modo de usuario establece la marca de campo de bits principal en el miembro Flags de D3DDDI_ALLOCATIONINFO, se aplican ciertas restricciones a la estructura de DXGK_ALLOCATIONINFO en el miembro pAllocationInfo de la estructura DXGKARG_CREATEALLOCATION para la asignación en una llamada a la función DxgkDdiCreateAllocation del controlador de minipuerto de pantalla. Entre estas restricciones se incluyes las siguientes:

La asignación se asigna según las preferencias; de lo contrario, la asignación tiene como valor predeterminado el conjunto de segmentos de escritura admitido y todos los segmentos especificados del conjunto de segmentos de escritura deben ser accesibles para la CPU.
El controlador de minipuerto de pantalla no puede establecer las siguientes marcas de campo de bits en el miembro Flags de DXGK_ALLOCATIONINFO:
PermanentSysMem
Almacenado en memoria caché
Protegido
ExistingSysMem
ExistingKernelSysMem