Funzione NmrRegisterProvider (netioddk.h)

La funzione NmrRegisterProvider registra un modulo provider con nmR.

Sintassi

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

Parametri

[in] ProviderCharacteristics

Puntatore a un oggetto NPI_PROVIDER_CHARACTERISTICS struttura che descrive le caratteristiche del modulo del provider. Il modulo provider deve assicurarsi che questa struttura rimanga valida e residente in memoria, purché il modulo provider sia registrato con nmR.

[in] ProviderContext

Puntatore a un contesto fornito dal chiamante per la registrazione. Il modulo provider usa questo contesto per tenere traccia dello stato della registrazione del provider. Il contenuto del contesto di registrazione del modulo del provider è opaco al nmR. NmR passa questo puntatore al modulo provider ogni volta che chiama la funzione di callback providerAttachClient del modulo provider. Il modulo provider deve assicurarsi che questo contesto rimanga valido e residente in memoria, purché il modulo provider sia registrato con nmR.

[out] NmrProviderHandle

Puntatore a una variabile che riceve un handle usato dal nmR per rappresentare la registrazione del modulo del provider. Il modulo provider deve salvare questo handle e passarlo come parametro alla funzione NmrDeregisterProvider quando deregisters da NMR.

Valore restituito

La funzione NmrRegisterProvider restituisce uno dei codici NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	NmR ha registrato correttamente il modulo del provider.
STATUS_INSUFFICIENT_RESOURCES	NmR non disponeva di risorse di sistema sufficienti per registrare il modulo del provider.
Altri codici di stato	Si è verificato un errore.

Commenti

Un modulo provider chiama la funzione NmrRegisterProvider per registrare come provider di un'entità di rete in modo che possa collegarsi ai moduli client che registrano come client dello stesso npI .

Un modulo provider chiama in genere la funzione NmrRegisterProvider dalla relativa funzione DriverEntry dopo aver completato tutte le altre attività di inizializzazione. La chiamata alla funzione NmrRegisterProvider indica al nmR che il modulo provider è pronto per connettersi a tutti i moduli client registrati o registrati come client dello stesso npI per cui il modulo provider è registrato come provider.

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	PASSIVE_LEVEL

Vedi anche

DriverEntry

NPI_PROVIDER_CHARACTERISTICS

NmrDeregisterProvider