Función NmrRegisterClient (netioddk.h)

La función NmrRegisterClient registra un módulo de cliente con NMR.

Sintaxis

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

Parámetros

[in] ClientCharacteristics

Puntero a un NPI_CLIENT_CHARACTERISTICS estructura que describe las características del módulo de cliente. El módulo cliente debe asegurarse de que esta estructura permanece válida y residente en la memoria siempre que el módulo cliente esté registrado con nmR.

[in] ClientContext

Puntero a un contexto proporcionado por el autor de la llamada para el registro. El módulo cliente usa este contexto para realizar un seguimiento del estado del registro de cliente. El contenido del contexto de registro del módulo cliente es opaco para el NMR. El NMR pasa este puntero al módulo cliente cada vez que llama a la función de devolución de llamada ClientAttachProvider del módulo cliente. El módulo cliente debe asegurarse de que su contexto de registro permanece válido y residente en la memoria siempre que el módulo cliente esté registrado con nmR.

[out] NmrClientHandle

Puntero a una variable que recibe un identificador usado por el NMR para representar el registro del módulo cliente. El módulo cliente debe guardar este identificador y pasarlo como parámetro a la función NmrDeregisterClient cuando se anula el registro de NMR.

Valor devuelto

La función NmrRegisterClient devuelve uno de los siguientes códigos NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	NmR registró correctamente el módulo de cliente.
STATUS_INSUFFICIENT_RESOURCES	El NMR no tenía suficientes recursos del sistema para registrar el módulo cliente.
Otros códigos de estado	Se produjo un error.

Comentarios

Un módulo cliente llama a la función NmrRegisterClient para registrarse como un cliente de un NPI para que pueda asociarse a módulos de proveedor que se registren como proveedores del mismo NPI .

Normalmente, un módulo cliente llama a la función NmrRegisterClient desde su función DriverEntry después de completar todas las demás tareas de inicialización. La llamada a la función NmrRegisterClient indica al NMR que el módulo cliente está listo para asociarse a los módulos de proveedor que se han registrado o se registrarán como proveedores del mismo NPI para el que el módulo cliente se ha registrado como cliente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	netioddk.h (incluya Wsk.h)
Library	Netio.lib
IRQL	PASSIVE_LEVEL

Consulte también

DriverEntry

NPI_CLIENT_CHARACTERISTICS

NmrDeregisterClient