Metodo IPnpCallbackHardware::OnPrepareHardware (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 OnPrepareHardware notifica a un driver di rendere accessibile l'hardware specificato.

Sintassi

HRESULT OnPrepareHardware(
  [in] IWDFDevice *pWdfDevice
);

Parametri

[in] pWdfDevice

Puntatore all'interfaccia IWDFDevice per l'oggetto dispositivo del dispositivo da rendere accessibile.

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 IPnpCallbackHardware::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, deve essere in grado di gestire la pulizia delle risorse parziali.

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 chiama il metodo IWDFDriver::CreateDevice per creare un oggetto dispositivo.

La ricezione di una chiamata al metodo OnPrepareHardware equivale a un driver WDM (Microsoft Windows Driver Model) che riceve un IRP_MN_START_DEVICE IRP.

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