estrutura D3DDDIARG_OPENRESOURCE (d3dumddi.h)

A estrutura D3DDDIARG_OPENRESOURCE contém informações para abrir um recurso compartilhado.

Sintaxe

typedef struct _D3DDDIARG_OPENRESOURCE {
  [in]     UINT                      NumAllocations;
  union {
    [in]     D3DDDI_OPENALLOCATIONINFO  *pOpenAllocationInfo;
             D3DDDI_OPENALLOCATIONINFO2 *pOpenAllocationInfo2;
  };
  [in]     D3DDDI_OPENALLOCATIONINFO *pOpenAllocationInfo;
  [in]     D3DKMT_HANDLE             hKMResource;
  [in]     VOID                      *pPrivateDriverData;
  [in]     UINT                      PrivateDriverDataSize;
  [in/out] HANDLE                    hResource;
  [in]     D3DDDI_ROTATION           Rotation;
  [in]     D3DDDI_OPENRESOURCEFLAGS  Flags;
} D3DDDIARG_OPENRESOURCE;

Membros

[in] NumAllocations

O número de elementos na matriz especificada por pOpenAllocationInfo. NumAllocations representa o número de alocações a serem abertas.

[in] pOpenAllocationInfo

Uma matriz de estruturas D3DDDI_OPENALLOCATIONINFO que descrevem as alocações no recurso a ser aberto.

[in] Uma matriz de estruturas D3DDDI_OPENALLOCATIONINFO que descrevem as alocações no recurso a ser aberto.

pOpenAllocationInfo2

Esse membro é reservado e deve ser definido como zero.

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

[in] hKMResource

Um tipo de dados D3DKMT_HANDLE que representa um identificador de modo kernel para o recurso associado às alocações.

Esse identificador de modo kernel representa um recurso compartilhado existente que foi criado anteriormente por meio de uma chamada para a função CreateResource do driver de exibição no modo de usuário.

[in] pPrivateDriverData

Um ponteiro para dados privados que foi passado para o driver de miniporta de exibição quando o recurso foi criado. Esses dados são por recurso e não por alocação, como os dados privados na estrutura D3DDDI_OPENALLOCATIONINFO de cada alocação.

[in] PrivateDriverDataSize

O tamanho, em bytes, dos dados privados apontados por pPrivateDriverData.

[in/out] hResource

Um identificador para o recurso associado às alocações.

O driver de exibição do modo de usuário deve salvar esse identificador e usá-lo para identificar o recurso sempre que o driver chamar de volta para o runtime do Microsoft Direct3D. O driver de exibição do modo de usuário deve gerar um identificador exclusivo e passá-lo de volta para o runtime do Direct3D. O runtime do Direct3D usa esse identificador em chamadas de driver para identificar o recurso.

[in] Rotation

Um valor de tipo D3DDDI_ROTATION que identifica a orientação do recurso primário compartilhado.

Quando o recurso primário é usado com um dispositivo de tela inteira e é girado, o driver pode ser necessário para criar alocações provisórias para lidar com o dispositivo de tela inteira. O sinalizador de campo de bits Fullscreen é definido no membro Flags para indicar que o recurso primário é usado com um dispositivo de tela inteira.

[in] Flags

Uma estrutura D3DDDI_OPENRESOURCEFLAGS que identifica o tipo de recurso a ser aberto.

Comentários

Os sinalizadores de campo de bit Primary e SharedResource são definidos no membro Flags da estrutura D3DDDIARG_CREATERESOURCE em uma chamada para a função CreateResource para criar um recurso primário compartilhado.

Requisitos

Confira também

CreateResource

D3DDDIARG_CREATERESOURCE

D3DDDI_OPENALLOCATIONINFO

D3DDDI_OPENRESOURCEFLAGS

D3DDDI_ROTATION

OpenResource