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 informazioni, vedi Introduzione a UMDF.]
Il metodo OnPrepareHardware esegue tutte le operazioni necessarie per rendere un dispositivo accessibile 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 framework che identifica le risorse hardware non elaborate assegnate dal gestore Plug and Play al dispositivo.
[in] pWdfResourcesTranslated
Puntatore all'interfaccia IWDFCmResourceList per l'oggetto elenco risorse 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 le 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.
Osservazioni
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.
Esempi
Vedere il codice di esempio in IWDFDevice3::MapIoSpace.
Fabbisogno
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| piattaforma di destinazione | Desktop |
| versione minima di UMDF | 1.11 |
| intestazione | wudfddi.h |