Compartilhar via


Macro EngLoadImage (winddi.h)

A função EngLoadImage carrega a imagem executável especificada na memória do modo kernel.

Sintaxe

void EngLoadImage(
  [in]  filename
);

Parâmetros

[in] filename

Ponteiro para uma cadeia de caracteres terminada em nulo que nomeia o arquivo que contém a imagem executável a ser carregada.

Retornar valor

Nenhum

Comentários

Um driver pode usar EngLoadImage para mapear uma imagem executável na memória do modo kernel. Por exemplo, um driver de impressora pode chamar EngLoadImage para carregar um minidriver.

EngLoadImage exige que o arquivo de imagem seja carregado com um sufixo.dll . O driver deve incluir esse sufixo na cadeia de caracteres pwszDriver .

Para executar uma seção de código dentro da imagem carregada, o driver deve obter o endereço da função de EngFindImageProcAddress.

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

Os drivers que precisam carregar um módulo como dados só devem chamar EngLoadModule ou EngLoadModuleForWrite em vez dessa função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Universal
Cabeçalho winddi.h (inclua Winddi.h)
Biblioteca Win32k.lib
DLL Win32k.sys

Confira também

EngLoadModule

EngLoadModuleForWrite

EngUnloadImage