IDirectDraw::SetCooperativeLevel

Artigo
09/09/2008

Windows Mobile Supported Windows Embedded CE Supported

9/8/2008

Este método determina o de alto nível comportamento do aplicativo.

Syntax

HRESULT SetCooperativeLevel(
  HWND hWnd, 
  DWORD dwFlags
);

Parameters

hWnd
Janela identificador usado para o aplicativo. Defina como janela de alto nível identificador do aplicativo de chamada (não um identificador para qualquer janelas filho criadas pelo janela de alto nível). Este parâmetro pode ser NULL quando o sinalizador DDSCL_NORMAL é especificada na dwFlags parâmetro.

dwFlags
A seguinte tabela mostra os sinalizadores possíveis.

Sinalizador	Descrição
DDSCL_FULLSCREEN	Indica que o exclusivo-modo proprietário será responsável para o primário inteiro superfície. GDI pode ser ignorada. Esse sinalizador deve ser usado com o sinalizador DDSCL_EXCLUSIVE.
DDSCL_NORMAL	Indica que o aplicativo será função como um regular aplicativo do Windows. Este sinalizador não pode ser usado com os sinalizadores DDSCL_ALLOWMODEX, DDSCL_EXCLUSIVE ou DDSCL_FULLSCREEN. A atual implementação Windows Embedded CE permite que processos com normal nível aos recursos do DirectDraw acessar quando há um processo em completo-modo Exclusivo Tela. Os processos no modo normal podem acessar primário surfaces mas são restrito com relação a inversão, criando primaries complexas e configuração exibir modos. Um processo pode entrar no total-modo Exclusivo Tela se nenhum outro processo estiver em modo exclusivo, regardless of se processos estão execução em um nível de cooperação normal.

DDSCL_FULLSCREEN

Indica que o exclusivo-modo proprietário será responsável para o primário inteiro superfície. GDI pode ser ignorada.

Esse sinalizador deve ser usado com o sinalizador DDSCL_EXCLUSIVE.

DDSCL_NORMAL

Indica que o aplicativo será função como um regular aplicativo do Windows.

Este sinalizador não pode ser usado com os sinalizadores DDSCL_ALLOWMODEX, DDSCL_EXCLUSIVE ou DDSCL_FULLSCREEN.

A atual implementação Windows Embedded CE permite que processos com normal nível aos recursos do DirectDraw acessar quando há um processo em completo-modo Exclusivo Tela.

Os processos no modo normal podem acessar primário surfaces mas são restrito com relação a inversão, criando primaries complexas e configuração exibir modos.

Um processo pode entrar no total-modo Exclusivo Tela se nenhum outro processo estiver em modo exclusivo, regardless of se processos estão execução em um nível de cooperação normal.

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_EXCLUSIVEMODEALREADYSET

DDERR_INVALIDOBJECT

DDERR_INVALIDPARAMS

DDERR_OUTOFMEMORY

Para obter mais informações sobre esses erros códigos Consulte DirectDraw Return Values.

Remarks

Esse método deve ser chamado pelo mesmo segmento que criou a janela do aplicativo.

Interação entre este método e a IDirectDraw::SetDisplayMode método difere do seu IDirectDraw similares.

Os desenvolvedores usando Microsoft Foundation Classes (MFC) deve manter lembre-se de que o identificador janela passado para este método deve identificar janela de alto nível do aplicativo, não um derivado janela filho.

Para recuperar parte superior do o aplicativo MFC nível manipulador de janela, use o seguinte codificar.

    HWND hwndTop = AfxGetMainWnd()->GetSafeHwnd();

Código de exemplo

Um exemplo mostrando o uso desta função pode ser encontrado no tópico How to use DirectDraw.

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

Compartilhar via