D3COLD_REQUEST_AUX_POWER función de devolución de llamada (wdm.h)

Permite que el objeto de dispositivo de función (FDO) transmita su requisito de energía auxiliar.

Sintaxis

D3COLD_REQUEST_AUX_POWER D3coldRequestAuxPower;

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

Parámetros

Context

Identificador del dispositivo.

[_In_] AuxPowerInMilliWatts

El wattage en unidades de mW que el dispositivo necesita para D3cold cuando el sistema está en S0. Este valor debe ser menor que 0x80000000.

[_Out_] RetryInSeconds

Puntero a una variable ULONG que recibe el número de segundos que el controlador puede reintentar su solicitud cuando se produce un error en la solicitud con STATUS_RETRY.

Valor devuelto

Devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código de error de valores NTSTATUS adecuado. Para obtener más información, vea Valores NTSTATUS. Los posibles errores son los siguientes:

Código de error	Descripción
STATUS_INVALID_PARAMETER	El parámetro de entrada no es válido.
STATUS_INVALID_DEVICE_REQUEST	El dispositivo no está en D0 o no el solicitante no es la función 0.
STATUS_RETRY	Error en la solicitud y el sistema indica que se puede realizar un reintento. RetryInSeconds contendrá el número de segundos que el controlador debe esperar antes de realizar la siguiente solicitud.
STATUS_UNSUCCESSFUL	Error en la solicitud y el sistema indica que el valor solicitado actual no es posible.
STATUS_SUCCESS	La solicitud finalizó correctamente.

Comentarios

Un controlador de dispositivo que consulta correctamente la interfaz GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE recibe un puntero a una estructura de D3COLD_AUX_POWER_AND_TIMING_INTERFACE en la que el controlador establece el miembro RequestAuxPower en un puntero a su implementación de la función de devolución de llamada D3COLD_REQUEST_AUX_POWER .

• Para un dispositivo de varias funciones, solo se espera que la función 0 llame a esta rutina y establezca la potencia auxiliar para todo el dispositivo.

• La función 0 debe estar en estado D0 cuando se llama a esta rutina.

• No hay ninguna garantía de que se quite la potencia del tren de alimentación principal después del éxito de esta solicitud.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1803
Encabezado	wdm.h (incluya Wdm.h)