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

Artigo
02/07/2025

Permite que o FDO (objeto do 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 potência 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 em que o driver pode repetir sua solicitação quando a solicitação falha com STATUS_RETRY.

Valor de retorno

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 erros possíveis são os seguintes:

Código de 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	A solicitação foi bem-sucedida.

Observações

Um driver de dispositivo que consulta com êxito a interface GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE recebe um ponteiro para uma estrutura de 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 com 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 for chamada.
Não há garantia de que a energia central do power rail será removida após o sucesso desta solicitação.

Requisitos

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

Compartilhar via