IDirect3DMobileDevice::Present
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este método é usado para tornar uma cena processada visível para o usuário, fazendo com que os dados a partir de buffer de fundo apareça na reserva frontal. Para obter mais informações, consulte Apresentação cena.
Syntax
HRESULT Present(
CONST RECT* pSourceRect,
CONST RECT* pDestRect,
HWND hDestWindowOverride,
CONST RGNDATA* pDirtyRegion
);
Parameters
- pSourceRect
[no] Ponteiro para um valor que deve ser NULL, a menos que o encadear trocar foi criado com D3DMSWAPEFFECT_COPY ou D3DMSWAPEFFECT_COPY_VSYNC. pSourceRecté um ponteiro para um RECT estrutura que contém o retângulo origem. Se NULL, a superfície origem inteira é apresentada. Se o retângulo exceder da superfície de origem, o retângulo é cortado para a superfície de origem.
- pDestRect
[no] Ponteiro para um valor que deve ser NULL, a menos que o encadear trocar foi criado com D3DMSWAPEFFECT_COPY ou D3DMSWAPEFFECT_COPY_VSYNC. PDestRect é um ponteiro para um RECT estrutura que contém o retângulo destino, na janela cliente coordenadas. Se NULL, a área cliente inteiro é preenchida. Se o retângulo exceder o área cliente destino, o retângulo é cortado a área cliente de destino.
- hDestWindowOverride
Não suportado.
- pDirtyRegion
[no] Este parâmetro não for usado e deve ser definido como NULL.
Return Value
Se o método for bem-sucedido, o valor de retorno é D3DM_OK (consulte Valores D3DM).
Se o método falhar, o valor de retorno pode ser uma do seguinte Valores D3DMERR.
- D3DMERR_INVALIDCALL
- D3DMERR_DEVICELOST
Remarks
Este método grava um token apresentação para a reserva de comando e, em seguida, faz com que a reserva de comando para ser liberado.
Ao contrário de IDirect3DDevice::Present método em área de trabalho Direct3D_for_Windows-Based sistemas, implementação do Direct3D Mobile de IDirect3DMobileDevice::Present Não inclui suporte para o hDestWindowOverride parâmetro.
Se um chamar para IDirect3DDevice::Present falha porque ele recebeu inválido parâmetros, os tokens restantes na reserva de comando são mantidos para processamento adicional. Se um chamar para IDirect3DDevice::Present Falha para qualquer outro motivo, em seguida, o conteúdo inteiro da reserva de comando é descartado.
Se necessário, um estender operação é aplicada ao transferir os pixels dentro do retângulo origem até o retângulo destino na área cliente da janela de destino.
Requirements
| Header | d3dm.h |
| Library | D3dm.lib, D3dmguid.lib |
| Windows Embedded CE | Windows CE 5.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |