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
| 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) |