Metodo IPnpCallbackHardware2::OnReleaseHardware (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 OnReleaseHardware esegue operazioni necessarie quando un dispositivo non è più accessibile.
Sintassi
HRESULT OnReleaseHardware(
[in] IWDFDevice3 *pWdfDevice,
[in] IWDFCmResourceList *pWdfResourcesTranslated
);
Parametri
[in] pWdfDevice
Puntatore all'interfaccia IWDFDevice3 per l'oggetto dispositivo framework.
[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
OnReleaseHardware 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).
Osservazioni
Un driver registra l'interfaccia IPnpCallbackHardware2 quando il driver chiama il metodo IWDFDriver::CreateDevice per creare un oggetto dispositivo.
Il metodo OnReleaseHardware deve liberare risorse allocate durante la chiamata al metodo IPnpCallbackHardware2::OnPrepareHardware, indipendentemente dal fatto che OnPrepareHardware riuscito o negativo. Di conseguenza, OnReleaseHardware deve essere in grado di gestire la pulizia delle risorse parziali.
Per informazioni sull'eliminazione di un oggetto interrupt, vedere Eliminazione di un oggetto interrupt.
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 |