Função FsRtlAddBaseMcbEntryEx (ntifs.h)

Artigo
12/21/2024

A função FsRtlAddBaseMcbEntryEx é usada para adicionar um novo mapeamento de números de bloco virtual (VBN's) a números de bloco lógico (LBN's) a um MCB (bloco de controle de mapa) existente.

Sintaxe

NTSTATUS FsRtlAddBaseMcbEntryEx(
  PBASE_MCB Mcb,
  LONGLONG  Vbn,
  LONGLONG  Lbn,
  LONGLONG  SectorCount
);

Parâmetros

Mcb

Fornece o Mcb no qual adicionar o novo mapeamento.

Vbn

Fornece o VBN inicial da nova execução de mapeamento para adicionar ao Mcb.

Lbn

Fornece o Lbn inicial da nova execução de mapeamento para adicionar ao Mcb.

SectorCount

Fornece o tamanho da nova execução de mapeamento (em setores).

Valor de retorno

Essa função retorna um dos seguintes valores NTSTATUS:

Estado	Significado
STATUS_SUCCESSFUL	o mapeamento foi adicionado com êxito (ou seja, os novos VBNs não colidiram com VBNs existentes),
STATUS_INSUFFICIENT_RESOURCES	Não havia memória para adicionar o novo mapeamento.
STATUS_UNSUCCESSFULL	Houve uma colisão com os novos VBN's e os VBN existentes.

Observações

O mapeamento para os VBNs ainda não deve existir no Mcb. Se o mapeamento continuar uma execução anterior, essa rotina realmente os unirá em 1 execução.

Se o pool não estiver disponível para armazenar as informações, essa rotina gerará um valor de status que indica recursos insuficientes.

Um valor lbn de entrada igual a zero é ilegal (ou seja, a estrutura mcb nunca mapeará um VBN para um valor zero lbn).

Requisitos

Requisito	Valor
cabeçalho	ntifs.h

Compartilhar via