Función ZwLoadDriver (wdm.h)

La rutina ZwLoadDriver carga un controlador en el sistema.

Sintaxis

NTSYSAPI NTSTATUS ZwLoadDriver(
  [in] PUNICODE_STRING DriverServiceName
);

Parámetros

[in] DriverServiceName

Puntero a una cadena Unicode contada que especifica una ruta de acceso a la clave del Registro del controlador, \Registry\Machine\System\CurrentControlSet\Services\<DriverName, donde <DriverName>> es el nombre del controlador.

Valor devuelto

ZwLoadDriver devuelve STATUS_SUCCESS o un valor NTSTATUS de error adecuado.

Comentarios

ZwLoadDriver carga dinámicamente un controlador de sistema de archivos o dispositivo en el sistema que se está ejecutando actualmente.

Si el sistema se ejecuta en modo seguro y el controlador no se carga porque no está en la lista de modo seguro, ZwLoadDriver devuelve STATUS_SUCCESS.

Un minifiltro debe usar FltLoadFilter en lugar de ZwLoadDriver para cargar un minifiltro auxiliar.

Si la llamada a la función ZwLoadDriver se produce en modo de usuario, debe usar el nombre "NtLoadDriver" en lugar de "ZwLoadDriver".

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Servicios del sistema nativo de Windows se pueden comportar de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte también

FltLoadFilter

RtlInitUnicodeString

UNICODE_STRING

Uso de las versiones Nt y Zw de las rutinas nativas de Servicios del sistema

ZwUnloadDriver