Metodo IPnpCallbackHardware2::OnPrepareHardware (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 info, vedi Introduzione con UMDF.]
Il metodo OnPrepareHardware esegue tutte le operazioni necessarie per rendere accessibile un dispositivo al driver.
Sintassi
HRESULT OnPrepareHardware(
[in] IWDFDevice3 *pWdfDevice,
[in] IWDFCmResourceList *pWdfResourcesRaw,
[in] IWDFCmResourceList *pWdfResourcesTranslated
);
Parametri
[in] pWdfDevice
Puntatore all'interfaccia IWDFDevice3 per l'oggetto dispositivo framework.
[in] pWdfResourcesRaw
Puntatore all'interfaccia IWDFCmResourceList per l'oggetto elenco risorse del framework che identifica le risorse hardware non elaborate assegnate dal gestore di Plug and Play al dispositivo.
[in] pWdfResourcesTranslated
Puntatore all'interfaccia IWDFCmResourceList per l'oggetto elenco risorse del framework che identifica le risorse hardware tradotte assegnate dal gestore Plug and Play al dispositivo.
Valore restituito
OnPrepareHardware restituisce S_OK se l'operazione ha esito positivo. In caso contrario, questo metodo restituisce uno dei codici di errore definiti in Winerror.h. Non restituire HRESULT_FROM_NT(STATUS_NOT_SUPPORTED).
Se OnPrepareHardware restituisce un codice di errore, il framework chiamerà comunque il metodo IPnpCallbackHardware2::OnReleaseHardware . Il metodo OnReleaseHardware può quindi liberare risorse allocate durante la chiamata a OnPrepareHardware. Poiché OnReleaseHardware deve liberare risorse per i casi di esito positivo e negativo di OnPrepareHardware, OnReleaseHardware deve essere in grado di gestire la pulizia delle risorse parziali.
Commenti
Il metodo IPnpCallbackHardware2::OnPrepareHardware differisce dal metodo IPnpCallbackHardware::OnPrepareHardware in quanto riceve risorse non elaborate e tradotte.
Per informazioni sull'analisi delle risorse hardware, vedere Ricerca e mapping delle risorse hardware in un driver UMDF.
Esempio
Vedere il codice di esempio in IWDFDevice3::MapIoSpace.
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1.11 |
| Intestazione | wudfddi.h |