Funzione NmrRegisterClient (netioddk.h)

  • Articolo

La funzione NmrRegisterClient registra un modulo client con NMR.

Sintassi

NTSTATUS NmrRegisterClient(
  [in]  PNPI_CLIENT_CHARACTERISTICS ClientCharacteristics,
  [in]  __drv_aliasesMem PVOID      ClientContext,
  [out] PHANDLE                     NmrClientHandle
);

Parametri

[in] ClientCharacteristics

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

[in] ClientContext

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

[out] NmrClientHandle

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

Valore restituito

La funzione NmrRegisterClient restituisce uno dei codici NTSTATUS seguenti:

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

Commenti

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

Un modulo client chiama in genere la funzione NmrRegisterClient dalla funzione DriverEntry dopo aver completato tutte le altre attività di inizializzazione. La chiamata alla funzione NmrRegisterClient indica al nmR che il modulo client è pronto per connettersi a tutti i moduli del provider registrati o registreranno come provider della stessa funzione NPI per cui il modulo client è registrato come client.

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_CLIENT_CHARACTERISTICS

NmrDeregisterClient