Compartilhar via


estrutura DXGK_GRAPHICSPOWER_REGISTER_OUTPUT (d3dkmthk.h)

Uma estrutura que contém dados de saída usados para gerenciar componentes de energia compartilhados.

Sintaxe

typedef struct _DXGK_GRAPHICSPOWER_REGISTER_OUTPUT {
  PVOID                                  DeviceHandle;
  DEVICE_POWER_STATE                     InitialGrfxPowerState;
  PDXGK_SET_SHARED_POWER_COMPONENT_STATE SetSharedPowerComponentStateCb;
  PDXGK_GRAPHICSPOWER_UNREGISTER         UnregisterCb;
} DXGK_GRAPHICSPOWER_REGISTER_OUTPUT, *PDXGK_GRAPHICSPOWER_REGISTER_OUTPUT;

Membros

DeviceHandle

Um identificador opaco que deve ser fornecido ao fazer retornos de chamada para o dispositivo gráfico.

InitialGrfxPowerState

O estado de energia do dispositivo gráfico representado pelo DeviceHandle no momento da manipulação de IOCTL interna. A chamada IOCTL e a análise desse InitialGrfxPowerState devem ser protegidas por um mutex que também proteja o retorno de chamada do PowerNotificationCb .

SetSharedPowerComponentStateCb

Um retorno de chamada para indicar se o componente de energia especificado está ativo. O índice do componente deve corresponder ao índice usado pelo driver gráfico quando o componente foi indicado na inicialização do driver e o componente deve ser um dos tipos de componente de energia compartilhada. Se esse retorno de chamada for usado para definir um estado que já foi definido por esse driver para esse dispositivo gráfico, a chamada não terá efeito.

Se estiver configurando um componente ativo, o driver gráfico será notificado de forma síncrona antes que esse retorno de chamada retorne. Esse retorno de chamada deve ser chamado de <= APC_LEVEL. É possível que essa chamada falhe com STATUS_DEVICE_REMOVED se o dispositivo estiver sendo removido e RemovalNotificationCb ainda não tiver sido chamado ou se o adaptador gráfico não estiver em execução. Consulte PDXGK_SET_SHARED_POWER_COMPONENT_STATE.

UnregisterCb

Um retorno de chamada para cancelar o registro com o driver gráfico. Todos os componentes de energia compartilhada não devem mais estar ativos. O sistema se comportará como se SetSharedPowerComponentStateCb tivesse sido chamado para todos os componentes ativos de energia compartilhada com um novo estado ativo de FALSE. Após o retorno, os retornos de chamada fornecidos anteriormente não podem mais ser usados. Esse retorno de chamada deve ser chamado de <= APC_LEVEL. Consulte PDXGK_GRAPHICSPOWER_UNREGISTER.

Requisitos

Requisito Valor
Cabeçalho d3dkmthk.h