estructura D3DDDIARG_OPENRESOURCE (d3dumddi.h)

Artículo
03/08/2023

La estructura D3DDDIARG_OPENRESOURCE contiene información para abrir un recurso compartido.

Sintaxis

typedef struct _D3DDDIARG_OPENRESOURCE {
  [in]     UINT                      NumAllocations;
  union {
    [in]     D3DDDI_OPENALLOCATIONINFO  *pOpenAllocationInfo;
             D3DDDI_OPENALLOCATIONINFO2 *pOpenAllocationInfo2;
  };
  [in]     D3DDDI_OPENALLOCATIONINFO *pOpenAllocationInfo;
  [in]     D3DKMT_HANDLE             hKMResource;
  [in]     VOID                      *pPrivateDriverData;
  [in]     UINT                      PrivateDriverDataSize;
  [in/out] HANDLE                    hResource;
  [in]     D3DDDI_ROTATION           Rotation;
  [in]     D3DDDI_OPENRESOURCEFLAGS  Flags;
} D3DDDIARG_OPENRESOURCE;

Miembros

[in] NumAllocations

Número de elementos de la matriz especificada por pOpenAllocationInfo. NumAllocations representa el número de asignaciones que se van a abrir.

[in] pOpenAllocationInfo

Matriz de estructuras de D3DDDI_OPENALLOCATIONINFO que describen las asignaciones del recurso que se van a abrir.

[in] Matriz de estructuras de D3DDDI_OPENALLOCATIONINFO que describen las asignaciones del recurso que se van a abrir.

pOpenAllocationInfo2

Este miembro está reservado y debe establecerse en cero.

Este miembro está disponible a partir de Windows 7.

[in] hKMResource

Un D3DKMT_HANDLE tipo de datos que representa un identificador en modo kernel para el recurso asociado a las asignaciones.

Este identificador de modo kernel representa un recurso compartido existente que se creó anteriormente a través de una llamada a la función CreateResource del controlador de visualización en modo de usuario.

[in] pPrivateDriverData

Puntero a los datos privados que se pasaron al controlador de miniporte para mostrar cuando se creó el recurso. Estos datos son por recurso y no por asignación, como los datos privados de la estructura D3DDDI_OPENALLOCATIONINFO de cada asignación.

[in] PrivateDriverDataSize

Tamaño, en bytes, de los datos privados a los que apunta pPrivateDriverData.

[in/out] hResource

Identificador del recurso asociado a las asignaciones.

El controlador de pantalla en modo de usuario debe guardar este identificador y usarlo para identificar el recurso en cualquier momento en que el controlador llame de nuevo al entorno de ejecución de Microsoft Direct3D. El controlador de pantalla en modo de usuario debe generar un identificador único y volver a pasarlo al entorno de ejecución de Direct3D. El entorno de ejecución de Direct3D usa este identificador en las llamadas de controlador para identificar el recurso.

[in] Rotation

Valor con tipo D3DDDI_ROTATION que identifica la orientación del recurso principal compartido.

Cuando el recurso principal se usa con un dispositivo de pantalla completa y se gira, es posible que el controlador tenga que crear asignaciones provisionales para controlar el dispositivo de pantalla completa. La marca de campo de bits Fullscreen se establece en el miembro Flags para indicar que el recurso principal se usa con un dispositivo de pantalla completa.

[in] Flags

Estructura D3DDDI_OPENRESOURCEFLAGS que identifica el tipo de recurso que se va a abrir.

Comentarios

Las marcas de campo de bits Primary y SharedResource se establecen en el miembro Flags de la estructura D3DDDIARG_CREATERESOURCE en una llamada a la función CreateResource para crear un recurso principal compartido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Encabezado	d3dumddi.h (incluya D3dumddi.h)