Condividi tramite


enumerazione CM_NOTIFY_ACTION (cfgmgr32.h)

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