Compartilhar via


Função CopyContext (winbase.h)

Copia uma estrutura de contexto de origem (incluindo qualquer XState) em uma estrutura de contexto de destino inicializada.

Sintaxe

BOOL CopyContext(
  [in, out] PCONTEXT Destination,
  [in]      DWORD    ContextFlags,
  [in]      PCONTEXT Source
);

Parâmetros

[in, out] Destination

Um ponteiro para uma estrutura CONTEXT de que recebe o contexto copiado dode Origem do . A estrutura CONTEXT deve ser inicializada chamando InitializeContext antes de chamar essa função.

[in] ContextFlags

Sinalizadores que especificam as partes da estrutura de context dede origem do que serão copiadas para o destino. Esse deve ser um subconjunto do ContextFlags especificado ao chamar InitializeContext nocontextde destino do .

[in] Source

Um ponteiro para uma estrutura CONTEXT da qual copiar dados de contexto do processador.

Valor de retorno

Essa função retornará TRUE se o contexto tiver sido copiado com êxito, caso contrário, false. Para obter informações de erro estendidas, chame GetLastError.

Observações

A função copia dados da CONTEXT sobre os dados correspondentes noCONTEXTO dede Destino , incluindo contexto estendido, se houver algum. A CONTEXT dede Destino deve ter sido inicializada com InitializeContext para garantir o alinhamento e a inicialização adequados. Se algum dado estiver presente na contextual dede destino e o sinalizador correspondente não estiver definido na contextual dede origem do ou no parâmetro ContextFlags , os dados permanecerão válidos node Destino .

Windows 7 com SP1 e Windows Server 2008 R2 com SP1: o da API AVX é implementado pela primeira vez no Windows 7 com SP1 e Windows Server 2008 R2 com SP1. Como não há nenhum SDK para SP1, isso significa que não há cabeçalhos e arquivos de biblioteca disponíveis para trabalhar. Nessa situação, um chamador deve declarar as funções necessárias desta documentação e obter ponteiros para elas usando GetModuleHandle em "Kernel32.dll", seguido de chamadas para GetProcAddress. Consulte Trabalhando com de Contexto XState para obter detalhes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 7 com SP1 [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2008 R2 com SP1 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho winbase.h (inclua Windows.h)
biblioteca Kernel32.lib
de DLL Kernel32.dll

Consulte também

CONTEXT

InitializeContext

Intel AVX

trabalhando com de contexto XState