PEP_POWER_CONTROL_REQUEST struttura (pep_x.h)
La struttura PEP_POWER_CONTROL_REQUEST contiene una richiesta da un driver per un'operazione di controllo energia.
Sintassi
typedef struct _PEP_POWER_CONTROL_REQUEST {
[in] PEPHANDLE DeviceHandle;
[in] LPCGUID PowerControlCode;
[in] PVOID InBuffer;
[in] SIZE_T InBufferSize;
[in] PVOID OutBuffer;
[in] SIZE_T OutBufferSize;
[out] SIZE_T BytesReturned;
[out] NTSTATUS Status;
} PEP_POWER_CONTROL_REQUEST, *PPEP_POWER_CONTROL_REQUEST;
Members
[in] DeviceHandle
Valore PEPHANDLE che identifica il dispositivo. Il PEP ha fornito questo handle in risposta a una notifica di PEP_DPM_REGISTER_DEVICE precedente.
[in] PowerControlCode
Puntatore a un valore GUID che specifica l'operazione di controllo energia da eseguire. Si tratta dello stesso valore fornito dal driver di richiesta come parametro PowerControlCode alla routine PoFxPowerControl .
[in] InBuffer
Puntatore a un buffer di input allocato dal driver che contiene i parametri di input per questa operazione di controllo energia. Si tratta dello stesso valore fornito dal driver di richiesta come parametro InBuffer alla routine PoFxPowerControl .
[in] InBufferSize
Dimensioni in byte del buffer a cui punta InBuffer. Si tratta dello stesso valore fornito dal driver di richiesta come parametro InBufferSize alla routine PoFxPowerControl .
[in] OutBuffer
Puntatore a un buffer di output allocato dal driver a cui il PEP scrive i risultati di questa operazione di controllo energia. Si tratta dello stesso valore fornito dal driver di richiesta come parametro OutBuffer alla routine PoFxPowerControl .
[in] OutBufferSize
Dimensioni in byte del buffer a cui punta OutBuffer.
[out] BytesReturned
Numero di byte che il PEP ha scritto nel buffer di output a cui fa riferimento OutBuffer.
[out] Status
Stato dell'operazione di controllo energia richiesta. Se l'operazione ha esito positivo, il PEP imposta questo membro su STATUS_SUCCESS. In caso contrario, il PEP imposta questo membro su un codice di stato di errore appropriato.
Commenti
Questa struttura viene usata dalla notifica di PEP_DPM_POWER_CONTROL_REQUEST . I primi sei membri della struttura contengono valori di input forniti da Windows Power Management Framework (PoFx). Gli ultimi due membri contengono valori che il PEP scrive nella struttura in risposta a questa notifica. Inoltre, il PEP scrive nel buffer di output a cui fa riferimento il membro OutBuffer .
Se il buffer di output è troppo piccolo per ricevere tutti i dati del risultato dall'operazione, il PEP imposta il membro Status della struttura su STATUS_INSUFFICIENT_RESOURCES, imposta il membro BytesReturned alle dimensioni necessarie del buffer di output e (in genere) non scrive dati nel buffer di output.
Il driver per un dispositivo può chiamare la routine PoFxPowerControl per richiedere un'operazione di controllo energia nel dispositivo. Durante questa chiamata, PoFx delega la gestione di questa richiesta al PEP proprietario del dispositivo. Il membro PowerControlCode della struttura PEP_POWER_CONTROL_REQUEST contiene un codice di controllo personalizzato il cui significato è compreso sia dal driver che dal PEP per il dispositivo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato a partire da Windows 10. |
| Intestazione | pep_x.h (includere Pep_x.h) |