NmrRegisterClient-Funktion (netioddk.h)
Die NmrRegisterClient-Funktion registriert ein Clientmodul beim NMR.
Syntax
NTSTATUS NmrRegisterClient(
[in] PNPI_CLIENT_CHARACTERISTICS ClientCharacteristics,
[in] __drv_aliasesMem PVOID ClientContext,
[out] PHANDLE NmrClientHandle
);
Parameter
[in] ClientCharacteristics
Ein Zeiger auf einen NPI_CLIENT_CHARACTERISTICS Struktur, die die Merkmale des Clientmoduls beschreibt. Das Clientmodul muss sicherstellen, dass diese Struktur gültig und im Arbeitsspeicher gespeichert bleibt, solange das Clientmodul beim NMR registriert ist.
[in] ClientContext
Ein Zeiger auf einen vom Aufrufer bereitgestellten Kontext für die Registrierung. Das Clientmodul verwendet diesen Kontext, um den Status der Clientregistrierung nachzuverfolgen. Der Inhalt des Registrierungskontexts des Clientmoduls ist für den NMR undurchsichtig. Der NMR übergibt diesen Zeiger an das Clientmodul, wenn die ClientAttachProvider-Rückruffunktion des Clientmoduls aufgerufen wird. Das Clientmodul muss sicherstellen, dass sein Registrierungskontext gültig bleibt und sich im Arbeitsspeicher befindet, solange das Clientmodul beim NMR registriert ist.
[out] NmrClientHandle
Ein Zeiger auf eine Variable, die ein Handle empfängt, das vom NMR verwendet wird, um die Registrierung des Clientmoduls darzustellen. Das Clientmodul muss dieses Handle speichern und als Parameter an die NmrDeregisterClient-Funktion übergeben, wenn die Registrierung aus dem NMR aufgehoben wird.
Rückgabewert
Die NmrRegisterClient-Funktion gibt einen der folgenden NTSTATUS-Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Der NMR hat das Clientmodul erfolgreich registriert. |
|
Der NMR verfügte nicht über ausreichende Systemressourcen, um das Clientmodul zu registrieren. |
|
Ein Fehler ist aufgetreten. |
Hinweise
Ein Clientmodul ruft die NmrRegisterClient-Funktion auf, um sich als Client einer NPI zu registrieren, damit es an Anbietermodule anfügen kann, die sich als Anbieter derselben NPI registrieren.
Ein Clientmodul ruft in der Regel die NmrRegisterClient-Funktion über seine DriverEntry-Funktion auf, nachdem es alle anderen Initialisierungsaufgaben abgeschlossen hat. Der Aufruf der NmrRegisterClient-Funktion gibt dem NMR an, dass das Clientmodul bereit ist, alle Anbietermodule anzufügen, die sich als Anbieter derselben NPI registriert haben oder registrieren, für die das Clientmodul als Client registriert ist.
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 | PASSIVE_LEVEL |