estructura D3DDDIARG_OPENRESOURCE (d3dumddi.h)
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) |