Compartilhar via


Função ZwLoadDriver (wdm.h)

A rotina ZwLoadDriver carrega um driver no sistema.

Sintaxe

NTSYSAPI NTSTATUS ZwLoadDriver(
  [in] PUNICODE_STRING DriverServiceName
);

Parâmetros

[in] DriverServiceName

Ponteiro para uma cadeia de caracteres Unicode contada que especifica um caminho para a chave do Registro do driver, \Registry\Machine\System\CurrentControlSet\Services\<DriverName>, em < que DriverName> é o nome do driver.

Retornar valor

ZwLoadDriver retorna STATUS_SUCCESS ou um valor NTSTATUS de erro apropriado.

Comentários

O ZwLoadDriver carrega dinamicamente um driver de sistema de arquivos ou dispositivo no sistema em execução no momento.

Se o sistema estiver em execução no modo de segurança e o driver não for carregado porque ele não estiver na lista de modo seguro, zwLoadDriver retornará STATUS_SUCCESS.

Um minifiltro deve usar FltLoadFilter em vez de ZwLoadDriver para carregar um minifiltro de suporte.

Se a chamada para a função ZwLoadDriver ocorrer no modo de usuário, você deverá usar o nome "NtLoadDriver" em vez de "ZwLoadDriver".

Para chamadas de drivers no modo kernel, as versões NtXxx e ZwXxx de uma rotina dos Serviços do Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Confira também

FltLoadFilter

RtlInitUnicodeString

UNICODE_STRING

Usando versões Nt e Zw das rotinas dos Serviços de Sistema Nativo

ZwUnloadDriver