Função EngLoadModuleForWrite (winddi.h)

A função EngLoadModuleForWrite carrega o módulo executável especificado na memória do sistema para gravação.

Sintaxe

ENGAPI HANDLE EngLoadModuleForWrite(
  [in] LPWSTR pwsz,
  [in] ULONG  cjSizeOfModule
);

Parâmetros

[in] pwsz

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do arquivo a ser carregado.

[in] cjSizeOfModule

Especifica o tamanho, em bytes, do módulo a ser carregado.

Valor retornado

Se EngLoadModuleForWrite for bem-sucedido, o valor retornado será um identificador para o módulo que foi carregado. Caso contrário, NULL será retornado.

Comentários

EngLoadModuleForWrite carrega um arquivo de dados na memória do sistema com permissão de gravação. Para acessar o módulo carregado, o driver deve chamar EngMapModule com o identificador retornado por essa função.

EndLoadModuleForWrite carrega o arquivo na memória que tem o mesmo tamanho do arquivo quando cjSizeOfModule é zero. Se cjSizeOfModule for maior que zero, a GDI estenderá ou truncará o arquivo para ser exatamente cjSizeOfModule bytes em tamanho antes de carregá-lo. Nenhuma suposição deve ser feita sobre o conteúdo da memória que se estende além do arquivo quando cjSizeOfModule é maior que o tamanho original do arquivo.

O arquivo identificado por pwsz deve estar localizado no diretório %SystemRoot%\System32 ou em um diretório encontrado na hierarquia de diretórios em %SystemRoot%\System32.

Para carregar um módulo com permissões somente leitura, o driver deve chamar EngLoadModule. Os drivers que precisam carregar uma imagem como código executável devem chamar EngLoadImage em vez dessa função.

Requisitos

Confira também

EngFreeModule

EngLoadImage

EngLoadModule

EngMapModule