Funzione PoCreatePowerRequest (ntifs.h)
La routine poCreatePowerRequest crea un oggetto richiesta di alimentazione.
Sintassi
NTSTATUS PoCreatePowerRequest(
[out] PVOID *PowerRequest,
[in] PDEVICE_OBJECT DeviceObject,
[in] PCOUNTED_REASON_CONTEXT Context
);
Parametri
[out] PowerRequest
Puntatore a una posizione in cui la routine scrive un puntatore all'oggetto power request appena creato. Se la chiamata ha esito negativo, la routine scrive NULL in questa posizione.
[in] DeviceObject
Puntatore all'oggetto dispositivo del chiamante (una struttura DEVICE_OBJECT).
[in] Context
Puntatore a una struttura COUNTED_REASON_CONTEXT che descrive il motivo per cui il chiamante sta creando l'oggetto power request. Questo parametro è facoltativo e può essere impostato su NULL.
Valore restituito
PoCreatePowerRequest restituisce STATUS_SUCCESS se la chiamata ha esito positivo. Se la chiamata ha esito negativo, i codici restituiti di errore possibili includono quanto segue:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Il parametro DeviceObject è NULL. |
| STATUS_INSUFFICIENT_RESOURCES | Memoria insufficiente per creare un oggetto power request. |
Osservazioni
Questa routine crea un oggetto power request. Per abilitare le richieste di alimentazione, il chiamante deve creare un oggetto power request e usare tale oggetto per tutte le chiamate alle routinePoSetPowerRequest e PoClearPowerRequest.
Un driver può usare richieste di alimentazione per eseguire l'override di alcuni aspetti del comportamento di alimentazione predefinito del computer. Ad esempio, un driver per un dispositivo ricevitore TV può usare richieste di alimentazione per impedire al risparmio energia di vuotare automaticamente lo schermo durante lunghi periodi di tempo in cui non si verifica alcuna interazione dell'utente.
Quando l'oggetto power request non è più necessario, il chiamante deve eliminare l'oggetto chiamando la routinePoDeletePowerRequest. Il driver deve eliminare l'oggetto richiesta di alimentazione prima di eliminare l'oggetto dispositivo usato per creare l'oggetto power request.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 7 |
| piattaforma di destinazione | Universale |
| intestazione | ntifs.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |