Función NmrRegisterProvider (netioddk.h)

La función NmrRegisterProvider registra un módulo de proveedor con nmR.

Sintaxis

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

Parámetros

[in] ProviderCharacteristics

Puntero a un NPI_PROVIDER_CHARACTERISTICS estructura que describe las características del módulo de proveedor. El módulo de proveedor debe asegurarse de que esta estructura siga siendo válida y resida en la memoria siempre que el módulo de proveedor esté registrado con nmR.

[in] ProviderContext

Puntero a un contexto proporcionado por el autor de la llamada para el registro. El módulo de proveedor usa este contexto para realizar un seguimiento del estado del registro del proveedor. El contenido del contexto de registro del módulo de proveedor es opaco para el NMR. NmR pasa este puntero al módulo de proveedor cada vez que llama a la función de devolución de llamada ProviderAttachClient del módulo de proveedor. El módulo de proveedor debe asegurarse de que este contexto siga siendo válido y resida en la memoria siempre que el módulo de proveedor esté registrado en nmr.

[out] NmrProviderHandle

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

Valor devuelto

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

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

Comentarios

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

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

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_PROVIDER_CHARACTERISTICS

NmrDeregisterProvider