Função NdisMapFile (ndis.h)

Artigo
02/29/2024

A função NdisMapFile mapeia um arquivo já aberto para um buffer acessível pelo chamador se o arquivo não for mapeado no momento.

Sintaxe

void NdisMapFile(
  [out] PNDIS_STATUS Status,
  [out] PVOID        *MappedBuffer,
  [in]  NDIS_HANDLE  FileHandle
);

Parâmetros

[out] Status

Um ponteiro para uma variável fornecida pelo chamador na qual essa função retorna a status da operação de mapeamento, que pode ser uma das seguintes:

NDIS_STATUS_SUCCESS

O chamador tem acesso exclusivo ao conteúdo do arquivo até que a função NdisUnmapFile seja chamada.

NDIS_STATUS_ALREADY_MAPPED

O chamador não pode acessar o conteúdo do arquivo no momento.

[out] MappedBuffer

Um ponteiro para uma variável fornecida pelo chamador na qual essa função retorna o endereço virtual base do conteúdo do arquivo mapeado ou NULL.

[in] FileHandle

O identificador que foi retornado por uma chamada anterior para a função NdisOpenFile .

Retornar valor

Nenhum

Comentários

O NdisMapFile associa (mapeia ) um intervalo de endereços virtuais a um arquivo aberto para que o driver possa acessar o conteúdo do arquivo. O NdisMapFile permite que apenas um mapeamento de um arquivo específico seja pendente a qualquer momento. Consequentemente, um chamador bem-sucedido recebe acesso exclusivo aos dados do arquivo até que NdisUnmapFile ou a função NdisCloseFile seja chamada.

Um driver de miniporta pode mapear e desmapear um arquivo aberto conforme necessário, usando chamadas alternadas para NdisMapFile e NdisUnmapFile. Uma chamada para NdisCloseFile libera o FileHandle e desaloca o buffer que contém o conteúdo do arquivo.

Um driver de miniporta pode chamar NdisMapFile somente durante a inicialização.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisMapFile (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisMapFile (NDIS 5.1)) no Windows XP.
Plataforma de Destino	Universal
Cabeçalho	ndis.h (inclua Video.h)
Biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regras de conformidade da DDI	Irql_Miscellaneous_Function(ndis)