Share via

Metodo IPnpCallbackHardware2::OnPrepareHardware (wudfddi.h)

  • Articolo

[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

Vedi anche

IPnpCallbackHardware2

OnReleaseHardware