NmrRegisterClient-Funktion (netioddk.h)

  • Artikel

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
STATUS_SUCCESS
 Der NMR hat das Clientmodul erfolgreich registriert.
STATUS_INSUFFICIENT_RESOURCES
 Der NMR verfügte nicht über ausreichende Systemressourcen, um das Clientmodul zu registrieren.
Andere status Codes
 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

Weitere Informationen

DriverEntry

NPI_CLIENT_CHARACTERISTICS

NmrDeregisterClient