PEP_POWER_CONTROL_REQUEST struttura (pepfx.h)

  • Articolo

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 pepfx.h (includere Pep_x.h)

Vedi anche

PEP_DPM_POWER_CONTROL_REQUEST

PEP_DPM_REGISTER_DEVICE

PoFxPowerControl