Funzione CopyContext (winbase.h)

Articolo
07/16/2024

Copia una struttura del contesto di origine (incluso qualsiasi XState) in una struttura di contesto di destinazione inizializzata.

Sintassi

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

Parametri

[in, out] Destination

Puntatore a una struttura CONTEXT che riceve il contesto copiato dalorigine . La struttura CONTEXT deve essere inizializzata chiamando InitializeContext prima di chiamare questa funzione.

[in] ContextFlags

Flag che specificano le parti della strutturaCONTEXT source che verranno copiate nella destinazione. Deve trattarsi di un subset del ContextFlags specificato quando si chiama InitializeContext nellaCONTEXT Destination.

[in] Source

Puntatore a una struttura CONTEXT da cui copiare i dati del contesto del processore.

Valore restituito

Questa funzione restituisce TRUE se il contesto è stato copiato correttamente; in caso contrario, FALSE. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

La funzione copia i dati dal CONTEXTsource sui dati corrispondenti nel DestinationCONTEXT, incluso il contesto esteso, se presente. Il CONTEXTdi destinazione deve essere stato inizializzato con InitializeContext per garantire l'allineamento e l'inizializzazione appropriati. Se sono presenti dati nella CONTEXT Destinatione il flag corrispondente non è impostato nel CONTEXT Sourceo nel parametro ContextFlags , i dati rimangono validi nellaDestination.

Windows 7 con SP1 e Windows Server 2008 R2 con SP1: L'API AVX viene implementata per la prima volta in Windows 7 con SP1 e Windows Server 2008 R2 con SP1 . Poiché non è disponibile SDK per SP1, significa che non sono disponibili intestazioni e file di libreria da usare. In questo caso, un chiamante deve dichiarare le funzioni necessarie da questa documentazione e ottenere i puntatori usando GetModuleHandle in "Kernel32.dll", seguito dalle chiamate a GetProcAddress. Per informazioni dettagliate, vedere Uso del contesto XState.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 7 con SP1 [solo app desktop]
server minimo supportato	Windows Server 2008 R2 con SP1 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winbase.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

CONTEXT

InitializeContext

Intel AVX

Utilizzo del contesto XState

Condividi tramite