Condividi tramite


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 info, vedi Introduzione con 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 del 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).

Commenti

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 abbia avuto esito positivo 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.

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

OnPrepareHardware