Funzione IoRequestDeviceEject (wdm.h)

Articolo
08/08/2023

La routine IoRequestDeviceEject notifica alla gestione PnP che è stato premuto il pulsante di inserimento del dispositivo.

Sintassi

void IoRequestDeviceEject(
  [in] PDEVICE_OBJECT PhysicalDeviceObject
);

Parametri

[in] PhysicalDeviceObject

Puntatore al PDO per il dispositivo.

Valore restituito

nessuno

Osservazioni

Si noti che questa routine segnala una richiesta per l'espulsione del dispositivo, non l'espulsione multimediale.

In genere, un driver del bus PnP chiama IoRequestDeviceEject per notificare al gestore PnP che un utente ha premuto il pulsante di espulsione del dispositivo su uno dei relativi dispositivi figlio.

Un driver chiama questa routine, anziché inviare una richiesta di IRP_MN_EJECT , perché questa routine consente al gestore PnP di coordinare azioni aggiuntive per l'eiezione oltre all'invio dell'IRP. Ad esempio, la gestione PnP notifica i componenti in modalità utente e in modalità kernel registrati per la notifica delle modifiche nel dispositivo.

Il gestore PnP indirizza un arresto ordinato del dispositivo. Gestione PnP:

Crea un elenco di altri dispositivi interessati da questo dispositivo da espulsi.
Il gestore PnP esegue query per le relazioni di rimozione del dispositivo, le relazioni di esezione e le relazioni con il bus (dispositivi figlio).
Determina se il dispositivo e i relativi dispositivi possono essere rimossi dal software.
Il gestore PnP invia IRP_MN_QUERY_REMOVE_DEVICE indirizzi IP ai driver per il dispositivo e ai relativi dispositivi. Il gestore PnP invia anche notifiche a tutti i componenti in modalità utente e in modalità kernel registrati per la notifica di modifica del dispositivo nel dispositivo o a uno dei relativi dispositivi. Se uno dei driver o dei componenti in modalità utente ha esito negativo, gestione PnP visualizza una finestra di dialogo per notificare all'utente che l'espulso non è riuscito.
Il software rimuove il dispositivo e i relativi dispositivi.
Se i passaggi precedenti hanno esito positivo, il gestore PnP notifica i driver e le applicazioni registrati che il dispositivo e i relativi dispositivi vengono rimossi dal software. Il gestore PnP invia quindi IRP_MN_REMOVE_DEVICE IRP ai driver per il dispositivo e ai relativi dispositivi. I driver di funzione e filtro si scollegano dallo stack di dispositivi ed eliminano i relativi oggetti dispositivo per i dispositivi. I driver del bus mantengono gli oggetti PDO per i dispositivi, a meno che un dispositivo non sia andato fisicamente e il driver del bus omette il dispositivo nella risposta più recente a IRP_MN_QUERY_DEVICE_RELATIONS/BusRelations per il bus padre del dispositivo.
Indirizza il driver del bus a esettare il dispositivo (se possibile).
Il gestore PnP esegue passaggi diversi, a seconda delle funzionalità di espulsione del dispositivo:
- L'espulso ad accesso frequente è supportato.
  Se la funzionalità EjectSupported è impostata per il dispositivo, il dispositivo può essere inserito quando il sistema è in esecuzione (si trova nello stato di PowerSystemWorking ). Il gestore PnP invia una richiesta di IRP_MN_EJECT al driver del bus per il dispositivo. Qualsiasi funzione e driver di filtro scollegati in precedenza dallo stack in risposta all'IRP rimosso, quindi il driver del bus gestisce l'IRP espulso. Quando il driver del bus completa l'IRP, il gestore PnP prevede che il dispositivo sia fisicamente assente dal sistema.
- L'espulsione ad accesso frequente non è supportata.
  In questo caso, il dispositivo è rimovibile ma non supporta l'espulso. Il gestore PnP contrassegna il dispositivo come non presente/non funzionante correttamente. Il gestore PnP non riavvia il dispositivo finché un utente lo rimuove fisicamente e lo reinsere. In questo caso, il gestore PnP non invia un IRP_MN_EJECT.
Il driver del bus padre di un dispositivo imposta le funzionalità per un dispositivo, incluse le funzionalità di esezione, in risposta a una richiesta di IRP_MN_QUERY_CAPABILITIES . Un driver di funzione o filtro può specificare facoltativamente le funzionalità.

Quando un dispositivo viene espulso, i dispositivi figlio vengono rimossi fisicamente dal sistema insieme a esso.

Un'applicazione in modalità utente può avviare un'espulsa del dispositivo. In questo caso, nessun driver chiama questa routine, ma il sistema operativo chiama il gestore PnP per avviare i passaggi elencati in precedenza.

I chiamanti di IoRequestDeviceEject devono essere in esecuzione in IRQL <= DISPATCH_LEVEL. Il gestore PnP esegue la maggior parte delle attività di rimozione dei dispositivi elencate sopra in IRQL = PASSIVE_LEVEL.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (vedere sezione Osservazioni)

Vedi anche

IRP_MN_EJECT

IRP_MN_QUERY_DEVICE_RELATIONS

IRP_MN_QUERY_REMOVE_DEVICE

IRP_MN_REMOVE_DEVICE

Condividi tramite