IDirectDrawSurface::SetClipper
.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
Esse método anexa um Clipper objeto para ou exclui um de uma superfície.
Syntax
HRESULT SetClipper(
LPDIRECTDRAWCLIPPER lpDDClipper
);
Parameters
- lpDDClipper
Endereço das IDirectDrawClipper interface para o DirectDrawClipper objeto que será anexado para o DirectDrawSurface WScript.Shell. Se este parâmetro é NULL, a atual DirectDrawClipper objeto vai ser desanexado.
Return Value
Se o método for bem-sucedido, o valor de retorno é DD_OK.
Se o método falhar, o valor de retorno pode ser uma do seguinte valores de erro:
DDERR_INVALIDOBJECT |
DDERR_INVALIDPARAMS |
DDERR_NOCLIPPERATTACHED |
Para obter mais informações sobre esses erros códigos Consulte DirectDraw Return Values.
Remarks
Quando configuração uma Clipper para uma superfície para o primeiro tempo, esse método aumenta contagem de referência do Clipper; chamadas subseqüentes não afetam contagem de referência do Clipper.
Se você transmitir NULL como o lpDDClipper parâmetro, o Clipper é removido a superfície e contagem de referência do o Clipper é diminuída.
Se você não excluir o Clipper, a superfície libera sua referência para o Clipper quando a superfície próprio for lançada.
De acordo com regras COM, seu aplicativo é responsável por Liberando referências que ele mantém para a Clipper quando o objeto mais é necessária.
Este método é usado principalmente por que estão sendo sobrepostos em superfícies ou blitted para o primário superfície. No entanto, ele pode ser usado em qualquer superfície.
Após um DirectDrawClipper objeto foi anexado e um juntar lista está associado com ele, o DirectDrawClipper objeto será usado para o IDirectDrawSurface::Blt e IDirectDrawSurface::UpdateOverlay As operações que envolvem o pai DirectDrawSurface WScript.Shell.
Esse método pode também desanexar um DirectDrawSurface atual do objeto DirectDrawClipper WScript.Shell.
Requirements
| Header | ddraw.h |
| Library | ddraw.lib |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |
| Windows Mobile | Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later |