estructura D3DDDIARG_CREATERESOURCE2 (d3dukmdt.h)

Artículo
03/08/2023

Contiene información para crear un recurso. Usado por windows Display Driver Model (WDDM) 1.2 y controladores de pantalla en modo de usuario posteriores.

Sintaxis

typedef struct _D3DDDIARG_CREATERESOURCE2 {
  [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;
  [in]     D3DDDI_RESOURCEFLAGS2          Flags2;
} D3DDDIARG_CREATERESOURCE2;

Miembros

[in] Format

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

[in] Pool

Valor de tipo D3DDDI_POOL que indica el tipo de grupo de memoria a partir del que se crean los recursos.

[in] MultisampleType

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

[in] MultisampleQuality

Nivel de calidad de la representación de muestras 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 asignación 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 es aplicable 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 de 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 CreateResource2 , 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 al tiempo de ejecución de Direct3D. En la salida de la función CreateResource2 , hResource especifica el identificador que el tiempo de ejecución de Direct3D debe usar en las 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 de tipo D3DDDI_ROTATION 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 escaneo. 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 .

[in] Flags2

Estructura D3DDDI_RESOURCEFLAGS2 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_RESOURCEFLAGS2 requieren que también se establezcan marcas de campo de bits adicionales.