Função FsRtlAddBaseMcbEntryEx (ntifs.h)

A função FsRtlAddBaseMcbEntryEx é usada para adicionar um novo mapeamento de números de bloco virtual (VBN's) a números de bloco lógicos (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).

Retornar valor

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

Status	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.

Comentários

O mapeamento para as 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 status indicando recursos insuficientes.

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

Requisitos

Requisito	Valor
Cabeçalho	ntifs.h