PEP_POWER_CONTROL_COMPLETE struttura (pep_x.h)

La struttura PEP_POWER_CONTROL_COMPLETE contiene informazioni sullo stato per un'operazione di controllo energia 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 energia eseguita. Si tratta dello stesso valore fornito dal PEP in risposta alla notifica di PEP_DPM_WORK per avviare l'operazione di controllo dell'alimentazione.

[in] RequestContext

Puntatore al contesto di 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 energia 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 energia. 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_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 alle dimensioni necessarie del buffer di output e (in genere) non scrive dati nel buffer di output.

Requisiti

Vedi anche

GUID