NmrWaitForClientDeregisterComplete-Funktion (netioddk.h)

  • Artikel

Die NmrWaitForClientDeregisterComplete-Funktion wartet, bis die Registrierung eines Clientmoduls abgeschlossen ist.

Syntax

NTSTATUS NmrWaitForClientDeregisterComplete(
  [in] HANDLE NmrClientHandle
);

Parameter

[in] NmrClientHandle

Ein Handle, das vom NMR verwendet wird, um die Registrierung des Clientmoduls darzustellen. Der NMR gibt dieses Handle an das Clientmodul zurück, wenn das Clientmodul die NmrRegisterClient-Funktion aufruft.

Rückgabewert

Die NmrWaitForClientDeregisterComplete-Funktion gibt einen der folgenden NTSTATUS-Codes zurück:

Rückgabecode Beschreibung
STATUS_SUCCESS
 Der NMR hat die Registrierung des Clientmoduls aufgehoben.
STATUS_INVALID_PARAMETER
 Das Clientmodul hat die NmrWaitForClientDeregisterComplete-Funktion aufgerufen, bevor die NmrDeregisterClient-Funktion aufgerufen wird, oder das im NmrClientHandle-Parameter angegebene Handle ist kein gültiges Clienthandle.
Andere status Codes
 Ein Fehler ist aufgetreten.

Hinweise

Ein Clientmodul ruft die NmrWaitForClientDeregisterComplete-Funktion auf, um zu warten, bis die Registrierung des Clientmoduls abgeschlossen ist. Ein Clientmodul ruft die NmrWaitForClientDeregisterComplete-Funktion erst nach dem Aufrufen der NmrDeregisterClient-Funktion auf.

Ein Clientmodul ruft in der Regel die NmrWaitForClientDeregisterComplete-Funktion aus seiner Unload-Funktion auf, um zu warten, bis die Registrierung aus dem NMR vollständig aufgehoben ist, bevor das Clientmodul aus dem System entladen wird. Ein Clientmodul darf erst nach Abschluss der Deregistrierung von einem Aufruf der Unload-Funktion zurückgegeben werden.

Hinweis Wenn ein Clientmodul das Windows-Treiberframework verwendet, ruft es in der Regel die NmrWaitForClientDeregisterComplete-Funktion aus seiner EvtDriverUnload-Ereignisrückruffunktion auf. In dieser Situation darf das Clientmodul erst nach Abschluss der Deregistrierung von einem Aufruf seiner EvtDriverUnload-Funktion zurückkehren.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile netioddk.h (einschließen von Wsk.h)
Bibliothek Netio.lib
IRQL < DISPATCH_LEVEL

Weitere Informationen

NmrDeregisterClient