Metodo IPnpCallback::OnD0Entry (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]
Il metodo OnD0Entry notifica a un driver quando un dispositivo entra nello stato di alimentazione D0 in modo che il driver possa eseguire le operazioni necessarie, ad esempio abilitando il dispositivo.
Sintassi
HRESULT OnD0Entry(
[in] IWDFDevice *pWdfDevice,
[in] WDF_POWER_DEVICE_STATE previousState
);
Parametri
[in] pWdfDevice
Puntatore all'interfaccia IWDFDevice per l'oggetto dispositivo del dispositivo che entra nello stato di alimentazione D0.
[in] previousState
Valore WDF_POWER_DEVICE_STATEtipizzato che identifica lo stato di alimentazione del dispositivo prima di entrare nello stato di alimentazione D0.
Valore restituito
Se l'OnD0Entry callback non rileva errori, deve restituire S_OK o un altro codice di stato per cui SUCCEEDED(status) è uguale TRUE.
Se restituisce un codice di stato per il quale SUCCEEDED(status) è uguale FALSE, il framework rimuove il dispositivo. Se i driver del dispositivo non supportano altri dispositivi nel sistema, il gestore di I/O scarica i driver. Il framework invia una notifica al gestore PnP, che tenta quindi di riavviare il dispositivo richiedendo al driver del bus di rinumerare i propri dispositivi. Se il driver è stato scaricato, verrà ricaricato. In questo caso, il framework non chiamerà la funzione di callback del driver IPnpCallback::OnD0Exit.
I codici di errore HRESULT sono definiti in Winerror.h.
Osservazioni
Un driver registra l'interfaccia IPnpCallback quando chiama il metodo IWDFDriver::CreateDevice per creare un oggetto dispositivo.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| intestazione | wudfddi.h (include Wudfddi.h) |