Metodo IPnpCallback::OnD0Entry (wudfddi.h)

Articolo
03/05/2024

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta 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, vedere Introduzione con UMDF.]

Il metodo OnD0Entry notifica a un driver quando un dispositivo entra nello stato di alimentazione D0 in modo che il driver possa eseguire operazioni necessarie, ad esempio l'abilitazione del 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_STATE tipizzato che identifica lo stato di alimentazione del dispositivo prima di entrare nello stato di alimentazione D0.

Valore restituito

Se il callback OnD0Entry non rileva errori, deve restituire S_OK o un altro codice di stato per cui SUCCESSED(status) è uguale a TRUE.

Se restituisce un codice di stato per cui SUCCESSED(status) è uguale a 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 notifica al gestore PnP, che tenta quindi di riavviare il dispositivo richiedendo al driver del bus di riesenumerare i propri dispositivi. Se il driver è stato scaricato, verrà ricaricato. In questo caso, il framework non chiamerà la funzione di callback IPnpCallback::OnD0Exit .

I codici di errore HRESULT sono definiti in Winerror.h.