Funzione NmrDeregisterClient (netioddk.h)

Articolo
02/26/2024

La funzione NmrDeregisterClient deregisters un modulo client da NMR.

Sintassi

NTSTATUS NmrDeregisterClient(
  [in] HANDLE NmrClientHandle
);

Parametri

[in] NmrClientHandle

Handle usato da NMR per rappresentare la registrazione del modulo client. NmR restituisce questo handle al modulo client quando il modulo client chiama la funzione NmrRegisterClient .

Valore restituito

La funzione NmrDeregisterClient restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_PENDING	NmR ha avviato la registrazione del modulo client. Il modulo client deve chiamare il Funzione NmrWaitForClientDeregisterComplete per attendere il completamento della registrazione prima che il modulo client possa essere scaricato.
Altri codici di stato	Si è verificato un errore.

Commenti

Quando un modulo client chiama la funzione NmrDeregisterClient, nmR chiama la funzione di callback ClientDetachProvider del modulo client e la funzione di callback provider del modulo provider per ognuna delle associazioni tra il modulo client e un modulo provider. La registrazione del modulo client dal nmR viene completata dopo che il modulo client è stato scollegato correttamente da tutti i moduli del provider a cui è collegato e tutti i moduli del provider sono stati scollegati correttamente dal modulo client.

Un modulo client chiama in genere la funzione NmrDeregisterClient dalla funzione Scarica per scollegarsi da tutti i moduli del provider a cui è collegato prima che il modulo client venga scaricato dal sistema. Dopo aver chiamato la funzione NmrDeregisterClient , un modulo client deve chiamare l'oggetto Funzione NmrWaitForClientDeregisterComplete per attendere il completamento della registrazione prima che il modulo client possa essere scaricato. Un modulo client non deve tornare da una chiamata alla funzione Di caricamento fino al completamento della registrazione.

Nota Se un modulo client usa Windows Driver Framework, in genere chiamerà la funzione NmrDeregisterClient dalla relativa funzione di callback degli eventi EvtDriverUnload . In questa situazione, il modulo client non deve tornare da una chiamata alla relativa funzione EvtDriverUnload fino al completamento della registrazione.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	netioddk.h (include Wsk.h)
Libreria	Netio.lib
IRQL	<= DISPATCH_LEVEL