Metodo IPnpCallbackHardware::OnReleaseHardware (wudfddi.h)

Articolo
03/05/2024

[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 notifica a un driver di eseguire operazioni necessarie quando l'hardware specificato non è più accessibile.

Sintassi

HRESULT OnReleaseHardware(
  [in] IWDFDevice *pWdfDevice
);

Parametri

[in] pWdfDevice

Puntatore all'interfaccia IWDFDevice per l'oggetto dispositivo del dispositivo che non è più accessibile.

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).

Questo metodo deve usare la macro HRESULT_FROM_NT per restituire un valore HRESULT specifico per restituire lo stato a un client in modalità kernel. Per altre informazioni, vedere Supporto dei client in modalità kernel.

Commenti

Un driver registra l'interfaccia IPnpCallbackHardware 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 IPnpCallbackHardware::OnPrepareHardware se OnPrepareHardware ha avuto esito positivo o negativo. Pertanto, OnReleaseHardware deve essere in grado di gestire la pulizia delle risorse parziali.

Per altre informazioni, vedere Ricerca e mapping delle risorse hardware in un driver UMDF.