estrutura D3DDDIARG_CREATEDEVICE (d3dumddi.h)

  • Artigo

A estrutura D3DDDIARG_CREATEDEVICE contém informações que descrevem o dispositivo de exibição a ser criado.

Sintaxe

typedef struct _D3DDDIARG_CREATEDEVICE {
  [in/out] HANDLE                       hDevice;
  [in]     UINT                         Interface;
  [in]     UINT                         Version;
  [in]     const D3DDDI_DEVICECALLBACKS *pCallbacks;
  [in]     VOID                         *pCommandBuffer;
  [in]     UINT                         CommandBufferSize;
  [in]     D3DDDI_ALLOCATIONLIST        *pAllocationList;
  [in]     UINT                         AllocationListSize;
  [in]     D3DDDI_PATCHLOCATIONLIST     *pPatchLocationList;
  [in]     UINT                         PatchLocationListSize;
           D3DDDI_DEVICEFUNCS           *pDeviceFuncs;
  [in]     D3DDDI_CREATEDEVICEFLAGS     Flags;
           D3DGPU_VIRTUAL_ADDRESS       CommandBuffer;
} D3DDDIARG_CREATEDEVICE;

Membros

[in/out] hDevice

Um identificador para o dispositivo de exibição (contexto gráfico). Na entrada para a função CreateDevice , hDevice especifica o identificador que o driver deve usar quando 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 CreateDevice , hDevice especifica o identificador que o runtime do Direct3D usa em chamadas de driver subsequentes para identificar o dispositivo de exibição.

[in] Interface

A versão da interface Direct3D/DirectDraw (por exemplo, 7, 8 ou 9) que cria o dispositivo.

[in] Version

Um número que o driver pode usar para identificar quando o runtime direct3D/DirectDraw foi criado. Por exemplo, o driver pode usar o número de versão para diferenciar entre um runtime lançado com o Windows Vista e um runtime lançado com um service pack subsequente, que pode conter uma correção que o driver requer.

[in] pCallbacks

Um ponteiro para uma estrutura D3DDDI_DEVICECALLBACKS que contém uma tabela de funções de retorno de chamada de runtime direct3D que o driver pode usar.

[in] pCommandBuffer

Obsoleto. Para receber um ponteiro para o primeiro buffer que o driver de exibição do modo de usuário pode usar para comandos em lote, o driver deve primeiro chamar a função pfnCreateContextCb para criar um contexto para o dispositivo recém-criado.

[in] CommandBufferSize

Obsoleto.

[in] pAllocationList

Obsoleto. Para receber uma matriz de estruturas de D3DDDI_ALLOCATIONLIST para a lista de alocação inicial, o driver deve primeiro chamar a função pfnCreateContextCb para criar um contexto para o dispositivo recém-criado.

[in] AllocationListSize

Obsoleto.

[in] pPatchLocationList

Obsoleto. Para receber uma matriz de estruturas de D3DDDI_PATCHLOCATIONLIST para a lista de localização de patch inicial, o driver deve primeiro chamar a função pfnCreateContextCb para criar um contexto para o dispositivo recém-criado.

[in] PatchLocationListSize

Obsoleto.

pDeviceFuncs

[out] Um ponteiro para uma estrutura D3DDDI_DEVICEFUNCS que o driver de exibição do modo de usuário preenche com uma tabela de suas funções. O runtime do Direct3D usa essas funções para se comunicar com o driver de exibição do modo de usuário.

[in] Flags

Uma estrutura D3DDDI_CREATEDEVICEFLAGS que identifica como criar o dispositivo.

CommandBuffer

Esse membro é reservado e deve ser definido como zero.

Esse membro está disponível a partir do Windows 7.

Requisitos

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

Confira também

Createdevice

D3DDDI_CREATEDEVICEFLAGS

D3DDDI_DEVICECALLBACKS

D3DDDI_DEVICEFUNCS

DxgkDdiCreateDevice