Partilhar via


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

Dxgkrnl chama a função DxgkDdiPrepareLiveMigration do KMD para notificar o driver para se preparar para uma migração ao vivo que está prestes a começar.

Sintaxe

DXGKDDI_PREPARELIVEMIGRATION DxgkddiPreparelivemigration;

NTSTATUS DxgkddiPreparelivemigration(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_GPUP_PREPARE_LIVE_MIGRATION pArgs
)
{...}

Parâmetros

hAdapter

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

pArgs

[in] Um ponteiro para uma estrutura de DXGKARG_GPUP_PREPARE_LIVE_MIGRATION que contém as informações necessárias para se preparar para uma migração ao vivo.

Valor de retorno

DxgkDdiPrepareLiveMigration retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um código NTSTATUS apropriado.

Observações

Uma chamada para DxgkDdiPrepareLiveMigration permite que o driver configure a VF (função virtual), seu agendamento, seu próprio estado interno e qualquer outra coisa necessária em relação ao gerenciamento da migração. A intenção dessa chamada é estabelecer as políticas de agendamento PF/VF que fornecem a capacidade da migração ao vivo de transmitir conteúdo sujo da VRAM no host, preservando o desempenho justo para o VF. Se o rastreamento sujo for relatado como nãoperformante, esse retorno de chamada também será onde o rastreamento sujo é iniciado.

Para obter mais informações, consulte migração ao vivo em dispositivos GPU-P.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 11, versão 24H2 (WDDM 3.2)
cabeçalho d3dkmddi.h
IRQL PASSIVE_LEVEL

Consulte também

DXGKARG_GPUP_PREPARE_LIVE_MIGRATION

DxgkDdiEndLiveMigration