DXGKDDI_SAVEMUTABLEMIGRATIONDATA função de retorno de chamada (d3dkmddi.h)

Artigo
05/23/2024

A função DxgkDdiSaveMutableMigrationData do KMD coleta dados mutáveis para uma migração ao vivo que está prestes a terminar.

Sintaxe

DXGKDDI_SAVEMUTABLEMIGRATIONDATA DxgkddiSavemutablemigrationdata;

NTSTATUS DxgkddiSavemutablemigrationdata(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA pArgs
)
{...}

Parâmetros

hAdapter

[in] Um identificador para um bloco de contexto associado a um adaptador de exibição. O driver de miniporta de exibição forneceu anteriormente esse identificador para Dxgkrnl no parâmetro de saída MiniportDeviceContext da função DXGKDDI_ADD_DEVICE .

pArgs

[entrada/saída] Ponteiro para uma estrutura DXGKARG_GPUP_SAVE_MUTABLE_MIGRATION_DATA para obter informações relacionadas à chamada.

Retornar valor

DxgkDdiSaveMutableMigrationData retornará STATUS_SUCCESS se a chamada for bem-sucedida. Caso contrário, ele retornará um código NTSTATUS apropriado.

Comentários

DxgkDdiSaveMutableMigrationData é chamado para coletar dados mutáveis quando uma migração ao vivo está prestes a terminar. Essa DDI só deve ser chamada para VFs que estão em pausa no momento.

DxgkDdiSaveMutableMigrationData é chamado no padrão de buffer dinâmico clássico:

Na primeira chamada, DataSize é definido como 0 e Dados como NULL. O KMD deve alterar DataSize para o número total de bytes necessários para armazenar os dados imutáveis.
Dxgkrnl cria um buffer de bytes DataSize e faz uma segunda chamada com DataSize definido como o valor retornado por KMD e Dados apontando para o buffer alocado. Dxgkrnl controla o tempo de vida dessa memória alocada após a chamada.

DxgkDdiSaveImmutableMigrationData é chamado no início de uma migração dinâmica para coletar dados imutáveis.

Para obter mais informações, consulte Migração dinâmica em dispositivos GPU-P.