enumerazione CM_NOTIFY_ACTION (cfgmgr32.h)

Articolo
03/08/2023

Questa enumerazione identifica Plug and Play tipi di eventi del dispositivo.

Sintassi

typedef enum _CM_NOTIFY_ACTION {
  CM_NOTIFY_ACTION_DEVICEINTERFACEARRIVAL = 0,
  CM_NOTIFY_ACTION_DEVICEINTERFACEREMOVAL,
  CM_NOTIFY_ACTION_DEVICEQUERYREMOVE,
  CM_NOTIFY_ACTION_DEVICEQUERYREMOVEFAILED,
  CM_NOTIFY_ACTION_DEVICEREMOVEPENDING,
  CM_NOTIFY_ACTION_DEVICEREMOVECOMPLETE,
  CM_NOTIFY_ACTION_DEVICECUSTOMEVENT,
  CM_NOTIFY_ACTION_DEVICEINSTANCEENUMERATED,
  CM_NOTIFY_ACTION_DEVICEINSTANCESTARTED,
  CM_NOTIFY_ACTION_DEVICEINSTANCEREMOVED,
  CM_NOTIFY_ACTION_MAX
} CM_NOTIFY_ACTION, *PCM_NOTIFY_ACTION;

Costanti


`CM_NOTIFY_ACTION_DEVICEINTERFACEARRIVAL` Valore: 0 Per questo valore, impostare il membro FilterType della struttura CM_NOTIFY_FILTER per CM_NOTIFY_FILTER_TYPE_DEVICEINTERFACE. Questa azione indica che è stata abilitata un'interfaccia del dispositivo che soddisfa i criteri di filtro.
`CM_NOTIFY_ACTION_DEVICEINTERFACEREMOVAL` Per questo valore, impostare il membro FilterType della struttura CM_NOTIFY_FILTER per CM_NOTIFY_FILTER_TYPE_DEVICEINTERFACE. Questa azione indica che un'interfaccia del dispositivo che soddisfa i criteri di filtro è stata disabilitata.
`CM_NOTIFY_ACTION_DEVICEQUERYREMOVE` Per questo valore, impostare il membro FilterType della struttura CM_NOTIFY_FILTER per CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE. Questa azione indica che il dispositivo viene rimosso. Per consentire la rimozione della query, chiamare CloseHandle per chiudere gli handle aperti al dispositivo. In caso contrario, l'handle aperto impedisce la rimozione della query di questo dispositivo. Per altre informazioni, vedere Registrazione per la notifica dell'arrivo dell'interfaccia dispositivo e rimozione del dispositivo . Per rimuovere la query, restituire ERROR_CANCELLED. È tuttavia consigliabile non rimuovere la query e consentire la chiusura di eventuali handle aperti al dispositivo.
`CM_NOTIFY_ACTION_DEVICEQUERYREMOVEFAILED` Per questo valore, impostare il membro FilterType della struttura CM_NOTIFY_FILTER per CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE. Questa azione indica che la query rimossa di un dispositivo non è riuscita. Se l'handle è stato chiuso a questo dispositivo durante una notifica precedente di CM_NOTIFY_ACTION_DEVICEQUERYREMOVE, aprire un nuovo handle per continuare a inviare richieste di I/O al dispositivo. Per altre informazioni, vedere Registrazione per la notifica dell'arrivo dell'interfaccia dispositivo e rimozione del dispositivo .
`CM_NOTIFY_ACTION_DEVICEREMOVEPENDING` Per questo valore, impostare il membro FilterType della struttura CM_NOTIFY_FILTER per CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE. Il dispositivo verrà rimosso. Se si dispone ancora di un handle aperto nel dispositivo, chiamare CloseHandle per chiudere l'handle del dispositivo. Per altre informazioni, vedere Registrazione per la notifica dell'arrivo dell'interfaccia dispositivo e rimozione del dispositivo . Il sistema può inviare una notifica di CM_NOTIFY_ACTION_DEVICEREMOVEPENDING senza inviare un messaggio di CM_NOTIFY_ACTION_DEVICEQUERYREMOVE corrispondente. In questi casi, le applicazioni e i driver devono recuperare dalla perdita del dispositivo in modo ottimale.
`CM_NOTIFY_ACTION_DEVICEREMOVECOMPLETE` Per questo valore, impostare il membro FilterType della struttura CM_NOTIFY_FILTER per CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE. Il dispositivo è stato rimosso. Se si dispone ancora di un handle aperto nel dispositivo, chiamare CloseHandle per chiudere l'handle del dispositivo. Per altre informazioni, vedere Registrazione per la notifica dell'arrivo dell'interfaccia dispositivo e rimozione del dispositivo . Il sistema può inviare una notifica di CM_NOTIFY_ACTION_DEVICEREMOVECOMPLETE senza inviare messaggi di CM_NOTIFY_ACTION_DEVICEQUERYREMOVE o di CM_NOTIFY_ACTION_DEVICEREMOVEPENDING corrispondenti. In questi casi, le applicazioni e i driver devono recuperare dalla perdita del dispositivo in modo ottimale.
`CM_NOTIFY_ACTION_DEVICECUSTOMEVENT` Per questo valore, impostare il membro FilterType della struttura CM_NOTIFY_FILTER per CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE. Questa azione viene inviata quando si è verificato un evento personalizzato definito dal driver.
`CM_NOTIFY_ACTION_DEVICEINSTANCEENUMERATED` Per questo valore, impostare il membro FilterType della struttura CM_NOTIFY_FILTER per CM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE. Questa azione viene inviata quando è stata enumerata una nuova istanza del dispositivo che soddisfa i criteri di filtro.
`CM_NOTIFY_ACTION_DEVICEINSTANCESTARTED` Per questo valore, impostare il membro FilterType della struttura CM_NOTIFY_FILTER per CM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE. Questa azione viene inviata quando viene avviata un'istanza del dispositivo che soddisfa i criteri di filtro.
`CM_NOTIFY_ACTION_DEVICEINSTANCEREMOVED` Per questo valore, impostare il membro FilterType della struttura CM_NOTIFY_FILTER per CM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE. Questa azione viene inviata quando un'istanza del dispositivo che soddisfa i criteri di filtro non è più presente.
`CM_NOTIFY_ACTION_MAX` Non usare.

Commenti

Quando un driver chiama la funzione CM_Register_Notification , il parametro pCallback contiene un puntatore a una routine da chiamare quando si verifica un evento PnP specificato. Il parametro Action della routine di callback è un valore dell'enumerazione CM_NOTIFY_ACTION .

Requisiti

Requisito	Valore
Intestazione	cfgmgr32.h

Vedi anche

CM_NOTIFY_FILTER

CM_Register_Notification

Condividi tramite