Função NdisMapFile (ndis.h)
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) |