NmrRegisterProvider-Funktion (netioddk.h)

Die NmrRegisterProvider-Funktion registriert ein Anbietermodul beim NMR.

Syntax

NTSTATUS NmrRegisterProvider(
  [in]  PNPI_PROVIDER_CHARACTERISTICS ProviderCharacteristics,
  [in]  __drv_aliasesMem PVOID        ProviderContext,
  [out] PHANDLE                       NmrProviderHandle
);

Parameter

[in] ProviderCharacteristics

Ein Zeiger auf eine NPI_PROVIDER_CHARACTERISTICS Struktur, die die Merkmale des Anbietermoduls beschreibt. Das Anbietermodul muss sicherstellen, dass diese Struktur gültig bleibt und sich im Arbeitsspeicher befindet, solange das Anbietermodul beim NMR registriert ist.

[in] ProviderContext

Ein Zeiger auf einen vom Aufrufer bereitgestellten Kontext für die Registrierung. Das Anbietermodul verwendet diesen Kontext, um den Status der Anbieterregistrierung nachzuverfolgen. Der Inhalt des Registrierungskontexts des Anbietermoduls ist für den NMR undurchsichtig. Der NMR übergibt diesen Zeiger immer dann an das Anbietermodul, wenn es die ProviderAttachClient-Rückruffunktion des Anbietermoduls aufruft. Das Anbietermodul muss sicherstellen, dass dieser Kontext gültig bleibt und sich im Arbeitsspeicher befindet, solange das Anbietermodul beim NMR registriert ist.

[out] NmrProviderHandle

Ein Zeiger auf eine Variable, die ein Handle empfängt, das vom NMR zur Darstellung der Registrierung des Anbietermoduls verwendet wird. Das Anbietermodul muss dieses Handle speichern und es als Parameter an die NmrDeregisterProvider-Funktion übergeben, wenn die Registrierung beim NMR aufgehoben wird.

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der NMR hat das Anbietermodul erfolgreich registriert.
STATUS_INSUFFICIENT_RESOURCES	Der NMR verfügte nicht über ausreichende Systemressourcen, um das Anbietermodul zu registrieren.
Andere status Codes	Ein Fehler ist aufgetreten.

Hinweise

Ein Anbietermodul ruft die NmrRegisterProvider-Funktion auf, um sich als Anbieter eines NPI zu registrieren, damit es Clientmodule anfügen kann, die sich als Clients desselben NPI registrieren.

Ein Anbietermodul ruft in der Regel die NmrRegisterProvider-Funktion aus seiner DriverEntry-Funktion auf, nachdem alle anderen Initialisierungsaufgaben abgeschlossen wurden. Der Aufruf der NmrRegisterProvider-Funktion gibt dem NMR an, dass das Anbietermodul bereit ist, Clientmodule anzufügen, die sich als Clients derselben NPI registriert haben oder registrieren, für die das Anbietermodul als Anbieter 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 (include Wsk.h)
Bibliothek	Netio.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

DriverEntry

NPI_PROVIDER_CHARACTERISTICS

NmrDeregisterProvider