estrutura D3DDDIARG_CREATERESOURCE2 (d3dukmdt.h)

Artigo
02/23/2024

Contém informações para criar um recurso. Usado pelo WDDM (Modelo de Driver de Exibição do Windows) 1.2 e posteriores drivers de exibição do modo de usuário.

Sintaxe

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;

Membros

[in] Format

Um valor do tipo D3DDDIFORMAT que indica o formato dos recursos.

[in] Pool

Um valor do tipo D3DDDI_POOL que indica o tipo de pool de memória do qual os recursos são criados.

[in] MultisampleType

Um valor do tipo D3DDDIMULTISAMPLE_TYPE que indica o número de amostras para uma superfície de várias amostras. Se a superfície não for de várias amostras, esse valor será D3DDDIMULTISAMPLE_NONE (0).

[in] MultisampleQuality

O nível de qualidade de exemplos de renderização em uma superfície de várias amostras. O nível de qualidade deve ser um número de 0 a 7 que representa um nível de qualidade de 1 a 8, respectivamente.

Observe que, mesmo que a superfície não seja de várias amostras (ou seja, se D3DDDIMULTISAMPLE_NONE for especificado em MultisampleType), ela ainda poderá ter um nível de qualidade maior que 1 (que é especificado usando um número maior que 0).

[in] pSurfList

Uma matriz de estruturas D3DDDI_SURFACEINFO para a lista de superfícies (ou outros tipos de recursos) a serem criadas.

[in] SurfCount

O número de recursos na matriz especificada pelo membro pSurfList .

[in] MipLevels

O número de níveis de mapa de MIP para os recursos.

[in] Fvf

O formato FVF para buffers de vértice.

[in] VidPnSourceId

O número de identificação baseado em zero da fonte de vídeo presente em um caminho de uma topologia de VidPN (rede presente em vídeo) na qual a superfície primária é criada (se o recurso contiver uma superfície primária).

[in] RefreshRate

Uma estrutura D3DDDI_RATIONAL que especifica a taxa de atualização com a qual o recurso é usado. Esse membro será aplicável somente se o recurso for a superfície primária e o sinalizador de campo de bit MatchGdiPrimary não estiver definido no membro Flags . Além disso, se o sinalizador de campo de bits InterlacedRefresh estiver definido em Sinalizadores, o driver de exibição do modo de usuário determinará que a taxa de atualização será intercalada (caso contrário, progressiva).

[in/out] hResource

Um identificador para o recurso. Na entrada para a função CreateResource2 , hResource especifica o identificador que o driver deve usar sempre que chamar de volta para o runtime do Microsoft Direct3D.

O driver gera um identificador exclusivo e o passa de volta para o runtime do Direct3D. Na saída da função CreateResource2 , hResource especifica o identificador que o runtime do Direct3D deve usar em chamadas de driver subsequentes para identificar o recurso.

[in] Flags

Uma estrutura D3DDDI_RESOURCEFLAGS que identifica o tipo de recursos a serem criados. Observe que alguns dos sinalizadores de campo de bit em D3DDDI_RESOURCEFLAGS exigem que sinalizadores de campo de bits adicionais também sejam definidos.

[in] Rotation

Um valor de tipo D3DDDI_ROTATION que identifica a orientação do recurso.

Por exemplo, considere que o driver de exibição do modo de usuário recebe uma solicitação para que uma superfície 480x640 seja girada 90 graus (D3DDDI_ROTATION_90). O driver deve alocar a superfície no modo 640x480 para fins de verificação. Ao renderizar para a superfície, o driver deve executar a rotação de 90 graus.

Orientações diferentes de D3DDDI_ROTATION_IDENTITY são definidas somente quando o sinalizador de campo de bit primário também é definido no membro Flags .

[in] Flags2

Uma estrutura D3DDDI_RESOURCEFLAGS2 que identifica o tipo de recursos a serem criados. Observe que alguns dos sinalizadores de campo de bit em D3DDDI_RESOURCEFLAGS2 exigem que sinalizadores de campo de bits adicionais também sejam definidos.