Compartilhar via

D3COLD_REQUEST_AUX_POWER função de retorno de chamada (wdm.h)

  • Artigo

Permite que o FDO (objeto de dispositivo de função) transmita seu requisito de energia auxiliar.

Sintaxe

D3COLD_REQUEST_AUX_POWER D3coldRequestAuxPower;

NTSTATUS D3coldRequestAuxPower(
  [_In_reads_opt_(_Inexpressible_("varies"))] PVOID Context,
  [_In_]                                      ULONG AuxPowerInMilliWatts,
  [_Out_]                                     PULONG RetryInSeconds
)
{...}

Parâmetros

Context

O identificador para o dispositivo.

[_In_] AuxPowerInMilliWatts

A wattage em unidades de mW que o dispositivo precisa para D3cold quando o sistema está em S0. Esse valor deve ser menor que 0x80000000.

[_Out_] RetryInSeconds

Um ponteiro para uma variável ULONG que recebe o número de segundos que o driver pode repetir sua solicitação quando a solicitação falha com STATUS_RETRY.

Retornar valor

Retorne STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retorne um código de erro NTSTATUS Values apropriado. Para obter mais informações, consulte Valores NTSTATUS. Os possíveis erros são os seguintes:

Código do erro Descrição
STATUS_INVALID_PARAMETER O parâmetro de entrada não é válido.
STATUS_INVALID_DEVICE_REQUEST O dispositivo não está em D0 ou não o solicitante não é a Função 0.
STATUS_RETRY A solicitação falhou e o sistema indica que uma repetição pode ser feita. RetryInSeconds conterá o número de segundos que o driver deve aguardar antes de fazer a próxima solicitação.
STATUS_UNSUCCESSFUL A solicitação falhou e o sistema indica que o valor atual solicitado não é possível.
STATUS_SUCCESS Solicitação com êxito.

Comentários

Um driver de dispositivo que consulta com êxito a interface GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE recebe um ponteiro para uma estrutura D3COLD_AUX_POWER_AND_TIMING_INTERFACE na qual o driver define o membro RequestAuxPower como um ponteiro para sua implementação da função de retorno de chamada D3COLD_REQUEST_AUX_POWER .

  • Para um dispositivo de várias funções, espera-se que apenas a Função 0 chame essa rotina e defina a potência auxiliar para todo o dispositivo.

  • A função 0 deve estar no estado D0 quando essa rotina é chamada.

  • Não há garantia de que a energia principal do power rail será removida após o sucesso desta solicitação.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1803
Cabeçalho wdm.h (inclua Wdm.h)