estrutura D3DDDIARG_CREATERESOURCE2 (d3dukmdt.h)

Artigo
02/06/2025

Contém informações para criar um recurso. Usado pelo WDDM (Windows Display Driver Model) 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 exemplos para uma superfície de vários exemplos. Se a superfície não for 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ários exemplos. O nível de qualidade deve ser um número de 0 a 7 que represente 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 especificada no 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 especificado 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 origem do vídeo presente em um caminho de uma topologia VidPN (rede de vídeo presente) 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 MatchGdiPrimary sinalizador de campo de bit não estiver definido no membro sinalizadores de. Além disso, se o InterlacedRefresh sinalizador de campo de bit estiver definido em Flags, o driver de exibição no 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 ele chama 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 adicionais de campo de bit também sejam definidos.

[in] Rotation

Um valor D3DDDI_ROTATIONdigitado 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 de bits do Primário também é definido no membro sinalizadores do.

[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.