estructura D3DDDIARG_CREATERESOURCE (d3dukmdt.h)

Artículo
02/23/2024

La estructura D3DDDIARG_CREATERESOURCE contiene información para crear un recurso.

Sintaxis

typedef struct _D3DDDIARG_CREATERESOURCE {
  [in]     D3DDDIFORMAT                   Format;
  [in]     D3DDDI_POOL                    Pool;
  [in]     D3DDDIMULTISAMPLE_TYPE         MultisampleType;
  [in]     UINT                           MultisampleQuality;
  [in]     const D3DDDI_SURFACEINFO       *pSurfList;
  [in]     UINT                           SurfCount;
  [in]     UINT                           MipLevels;
  [in]     UINT                           Fvf;
  [in]     D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  [in]     D3DDDI_RATIONAL                RefreshRate;
  [in/out] HANDLE                         hResource;
  [in]     D3DDDI_RESOURCEFLAGS           Flags;
  [in]     D3DDDI_ROTATION                Rotation;
} D3DDDIARG_CREATERESOURCE;

Miembros

[in] Format

Valor con tipo D3DDDIFORMAT que indica el formato de los recursos.

[in] Pool

Valor con tipo D3DDDI_POOL que indica el tipo de grupo de memoria desde el que se crean los recursos.

[in] MultisampleType

Valor D3DDDIMULTISAMPLE_TYPE con tipo que indica el número de muestras de una superficie de muestreo múltiple. Si la superficie no tiene varias muestras, este valor es D3DDDIMULTISAMPLE_NONE (0).

[in] MultisampleQuality

El nivel de calidad de las muestras de representación en una superficie de muestreo múltiple. El nivel de calidad debe ser un número comprendido entre 0 y 7 que representa un nivel de calidad comprendido entre 1 y 8, respectivamente.

Tenga en cuenta que aunque la superficie no sea de muestreo múltiple (es decir, si D3DDDIMULTISAMPLE_NONE se especifica en MultisampleType), todavía puede tener un nivel de calidad mayor que 1 (que se especifica mediante un número mayor que 0).

[in] pSurfList

Matriz de estructuras de D3DDDI_SURFACEINFO para la lista de superficies (u otros tipos de recursos) que se van a crear.

[in] SurfCount

Número de recursos de la matriz especificada por el miembro pSurfList .

[in] MipLevels

Número de niveles de mapa de MIP para los recursos.

[in] Fvf

Formato FVF para búferes de vértices.

[in] VidPnSourceId

Número de identificación de base cero del origen del vídeo presente en una ruta de acceso de una topología de red presente de vídeo (VidPN) en la que se crea la superficie principal (si el recurso contiene una superficie principal).

[in] RefreshRate

Estructura D3DDDI_RATIONAL que especifica la frecuencia de actualización con la que se usa el recurso. Este miembro solo se aplica si el recurso es la superficie principal y la marca de campo de bits MatchGdiPrimary no está establecida en el miembro Flags . Además, si la marca de campo de bits InterlacedRefresh está establecida en Marcas, el controlador de pantalla en modo usuario determina que la velocidad de actualización está intercalada (de lo contrario, progresiva).

[in/out] hResource

Identificador del recurso. En la entrada de la función CreateResource , hResource especifica el identificador que el controlador debe usar cada vez que llame de nuevo al entorno de ejecución de Microsoft Direct3D.

El controlador genera un identificador único y lo pasa de nuevo al tiempo de ejecución de Direct3D. En la salida de la función CreateResource , hResource especifica el identificador que el entorno de ejecución de Direct3D debe usar en llamadas de controlador posteriores para identificar el recurso.

[in] Flags

Estructura D3DDDI_RESOURCEFLAGS que identifica el tipo de recursos que se van a crear. Tenga en cuenta que algunas de las marcas de campo de bits de D3DDDI_RESOURCEFLAGS requieren que también se establezcan marcas de campo de bits adicionales.

[in] Rotation

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

Por ejemplo, considere que el controlador de pantalla en modo de usuario recibe una solicitud de una superficie de 480 x 640 para girar 90 grados (D3DDDI_ROTATION_90). El controlador debe asignar la superficie en modo 640x480 con fines de examen. Al representar en la superficie, el controlador debe realizar la rotación de 90 grados.

Las orientaciones distintas de D3DDDI_ROTATION_IDENTITY solo se establecen cuando la marca de campo de bits principal también se establece en el miembro Flags .

Requisitos

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

Consulte también

CreateResource

D3DDDIFORMAT

D3DDDIMULTISAMPLE_TYPE