Função DCIBeginAccess (dciman.h)

[Essa função está sujeita a alterações com cada revisão do sistema operacional. Em vez disso, use o Microsoft DirectDraw e o Microsoft Direct3DAPIs; essas APIs isolam os aplicativos dessas alterações do sistema operacional e ocultam muitas outras dificuldades envolvidas na interação diretamente com drivers de exibição.]

Obtém um ponteiro de acesso para exibir o buffer de quadro com base no retângulo fornecido.

Sintaxe

DCIRVAL DCIBeginAccess(
  [in] LPDCISURFACEINFO pdci,
  [in] int              x,
  [in] int              y,
  [in] int              dx,
  [in] int              dy
);

Parâmetros

[in] pdci

Um ponteiro para uma estrutura DCISURFACEINFO .

[in] x

A coordenada X do canto superior esquerdo do retângulo.

[in] y

A coordenada y do canto superior esquerdo do retângulo.

[in] dx

A largura do retângulo.

[in] dy

A altura do retângulo.

Retornar valor

Se a função for bem-sucedida, o valor retornado será DCI_OK ou DCI_STATUS_POINTERCHANGED. DCI_STATUS_POINTERCHANGED indica que o endereço virtual do buffer de quadro pode ter sido alterado desde a última chamada. Portanto, o aplicativo não deve assumir a consistência do endereço virtual do buffer de quadro de exibição. Se a função falhar, o valor retornado será um dos erros de DCI.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	dciman.h
Biblioteca	Dciman32.lib
DLL	Dciman32.dll

Confira também

Suporte ao cliente de baixo nível de gráficos