WM_DEVICECHANGE messaggio

Articolo
06/22/2023

Notifica a un'applicazione di una modifica alla configurazione hardware di un dispositivo o del computer.

Una finestra riceve questo messaggio tramite la relativa funzione WindowProc .

LRESULT CALLBACK WindowProc(HWND   hwnd,     // handle to window
                            UINT   uMsg,     // WM_DEVICECHANGE
                            WPARAM wParam,   // device-change event
                            LPARAM lParam ); // event-specific data

Parametri

Hwnd

Handle nella finestra.

Umsg

Identificatore di WM_DEVICECHANGE .

wParam

Evento che si è verificato. Questo parametro può essere uno dei valori seguenti dal file di intestazione Dbt.h.

Valore	Significato
DBT_DEVNODES_CHANGED0x0007	Un dispositivo è stato aggiunto o rimosso dal sistema.
DBT_QUERYCHANGECONFIG0x0017	L'autorizzazione viene richiesta per modificare la configurazione corrente (dock o undock).
DBT_CONFIGCHANGED0x0018	La configurazione corrente è stata modificata, a causa di un dock o di undock.
DBT_CONFIGCHANGECANCELED0x0019	Una richiesta di modifica della configurazione corrente (dock o undock) è stata annullata.
DBT_DEVICEARRIVAL0x8000	Un dispositivo o un supporto multimediale è stato inserito ed è ora disponibile.
DBT_DEVICEQUERYREMOVE0x8001	L'autorizzazione viene richiesta per rimuovere un dispositivo o un elemento multimediale. Qualsiasi applicazione può negare questa richiesta e annullare la rimozione.
DBT_DEVICEQUERYREMOVEFAILED0x8002	È stata annullata una richiesta di rimozione di un dispositivo o di un supporto multimediale.
DBT_DEVICEREMOVEPENDING0x8003	Un dispositivo o un elemento multimediale sta per essere rimosso. Impossibile negare.
DBT_DEVICEREMOVECOMPLETE0x8004	È stato rimosso un dispositivo o un elemento multimediale.
DBT_DEVICETYPESPECIFIC0x8005	Si è verificato un evento specifico del dispositivo.
DBT_CUSTOMEVENT0x8006	Si è verificato un evento personalizzato.
DBT_USERDEFINED0xFFFF	Il significato di questo messaggio è definito dall'utente.

lParam

Puntatore a una struttura contenente dati specifici dell'evento. Il formato dipende dal valore del parametro wParam . Per altre informazioni, vedere la documentazione per ogni evento.

Valore restituito

Restituire TRUE per concedere la richiesta.

Restituire BROADCAST_QUERY_DENY per negare la richiesta.

Commenti

Per i dispositivi che offrono funzionalità controllabili dal software, ad esempio l'espulsione e il blocco, il sistema invia in genere un messaggio di DBT_DEVICEREMOVEPENDING per consentire alle applicazioni e ai driver di dispositivo di terminare l'uso del dispositivo in modo normale. Se il sistema rimuove in modo forcibly un dispositivo, potrebbe non inviare un messaggio di DBT_DEVICEQUERYREMOVE prima di farlo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP
Server minimo supportato	Windows Server 2003
Intestazione	Winuser.h (includono Windows.h o Dbt.h)

Vedi anche

DBT_CONFIGCHANGECANCELED
DBT_CONFIGCHANGED
DBT_CUSTOMEVENT
DBT_DEVICEARRIVAL
DBT_DEVICEQUERYREMOVE
DBT_DEVICEQUERYREMOVEFAILED
DBT_DEVICEREMOVECOMPLETE
DBT_DEVICEREMOVEPENDING
DBT_DEVICETYPESPECIFIC
DBT_DEVNODES_CHANGED
DBT_QUERYCHANGECONFIG
DBT_USERDEFINED

Condividi tramite