struttura PEP_POWER_CONTROL_COMPLETE (pepfx.h)

Articolo
08/07/2023

La struttura PEP_POWER_CONTROL_COMPLETE contiene informazioni sullo stato per un'operazione di controllo alimentazione richiesta in precedenza da PEP e che il driver del dispositivo è stato completato.

Sintassi

typedef struct _PEP_POWER_CONTROL_COMPLETE {
  [in] PEPHANDLE DeviceHandle;
  [in] LPCGUID   PowerControlCode;
  [in] PVOID     RequestContext;
  [in] SIZE_T    BytesReturned;
  [in] NTSTATUS  Status;
} PEP_POWER_CONTROL_COMPLETE, *PPEP_POWER_CONTROL_COMPLETE;

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 eseguita. Si tratta dello stesso valore fornito dal PEP in risposta alla notifica PEP_DPM_WORK per avviare l'operazione di controllo alimentazione.

[in] RequestContext

Puntatore al contesto della richiesta inviato dal PEP nella struttura PEP_WORK_INFORMATION fornita dal PEP nella richiesta di lavoro originale. In genere, questo membro punta a una struttura che contiene un puntatore a un buffer di output per contenere i risultati dell'operazione di controllo alimentazione richiesta dal PEP.

[in] BytesReturned

Dimensioni, in byte, dei dati dei risultati archiviati dal driver nel buffer di output. Per altre informazioni su questo buffer, vedere la descrizione del membro RequestContext .

[in] Status

Stato dell'operazione di controllo alimentazione. Se l'operazione ha avuto 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_COMPLETE . Tutti e cinque i membri della struttura contengono valori di input forniti da

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.

Requisiti

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

Vedi anche

GUID

Condividi tramite