Compartilhar via


estrutura D3DDDIARG_CREATERESOURCE (d3dukmdt.h)

A estrutura D3DDDIARG_CREATERESOURCE contém informações para criar um recurso.

Sintaxe

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;

Membros

[in] Format

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

[in] Pool

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

[in] MultisampleType

Um valor de 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 CreateResource , 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 CreateResource , 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 .

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho d3dukmdt.h (inclua D3dumddi.h, D3dkmddi.h)

Confira também

CreateResource

D3DDDIFORMAT

D3DDDIMULTISAMPLE_TYPE

D3DDDI_POOL

D3DDDI_RATIONAL

D3DDDI_ROTATION

D3DDDI_SURFACEINFO