struttura PEP_POWER_CONTROL_REQUEST (pepfx.h)

La struttura PEP_POWER_CONTROL_REQUEST contiene una richiesta da un driver per un'operazione di controllo alimentazione.

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 alimentazione da eseguire. Si tratta dello stesso valore fornito dal driver richiedente come parametro PowerControlCode alla routine PoFxPowerControlControl .

[in] InBuffer

Puntatore a un buffer di input allocato dal driver che contiene i parametri di input per questa operazione di controllo alimentazione. Si tratta dello stesso valore fornito dal driver richiedente 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 richiedente come parametro InBufferSize alla routine PoFxPowerControl .

[in] OutBuffer

Puntatore a un buffer di output allocato dal driver in cui pep scrive i risultati di questa operazione di controllo alimentazione. Si tratta dello stesso valore fornito dal driver richiedente come parametro OutBuffer alla routine PoFxPowerControl .

[in] OutBufferSize

Dimensioni in byte del buffer a cui punta OutBuffer.

[out] BytesReturned

Numero di byte scritti dal PEP nel buffer di output a cui punta OutBuffer.

[out] Status

Stato dell'operazione di controllo alimentazione 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 utilizzata 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 scritti dal PEP nella struttura in risposta a questa notifica. Inoltre, il PEP scrive nel buffer di output a cui punta 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 sulle 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 alimentazione 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

   
Client minimo supportato Supportato a partire da Windows 10.
Intestazione pepfx.h (include Pep_x.h)

Vedi anche

PEP_DPM_POWER_CONTROL_REQUEST

PEP_DPM_REGISTER_DEVICE

PoFxPowerControl