Funzione FsRtlLookupLargeMcbEntry (ntifs.h)

Articolo
10/04/2023

Dato un numero di blocco virtuale (VBN) e un blocco di controllo mappa (MCB), la routine FsRtlLookupLargeMcbEntry cerca le informazioni di mapping corrispondenti alla vbN specificata.

Sintassi

BOOLEAN FsRtlLookupLargeMcbEntry(
                  PLARGE_MCB Mcb,
                  LONGLONG   Vbn,
                  PLONGLONG  Lbn,
                  PLONGLONG  SectorCountFromLbn,
                  PLONGLONG  StartingLbn,
                  PLONGLONG  SectorCountFromStartingLbn,
  [out, optional] PULONG     Index
);

Parametri

Mcb

Puntatore a una struttura MCB inizializzata.

Vbn

Puntatore al VBN richiesto.

Lbn

Puntatore a una variabile che riceve il codice LBN mappato a LargeVbn nella voce di mapping o -1 se non esiste alcun LBN di questo tipo. Questo parametro è facoltativo e può essere NULL.

SectorCountFromLbn

Puntatore a una variabile che riceve il numero di settori che seguono LargeVbn nell'esecuzione del mapping. Questo parametro è facoltativo e può essere NULL.

StartingLbn

Puntatore a una variabile che riceve l'LBN corrispondente all'inizio dell'esecuzione del mapping o -1 se non esiste alcun LBN di questo tipo. Questo parametro è facoltativo e può essere NULL.

SectorCountFromStartingLbn

Puntatore a una variabile che riceve il numero di settori nell'esecuzione del mapping. Questo parametro è facoltativo e può essere NULL.

[out, optional] Index

Puntatore a una variabile che riceve l'indice dell'esecuzione del mapping contenente la vbN. Questo parametro è facoltativo e può essere NULL.

Valore restituito

FsRtlLookupLargeMcbEntry restituisce TRUE se la VBN specificata si trova all'interno dell'intervallo di VBN mappati da MCB, FALSE in caso contrario.

Commenti

FsRtlLookupLargeMcbEntry cerca una voce di mapping nel MCB la cui esecuzione include la vbN specificata.

Se tale mapping esiste, l'operazione di ricerca restituisce valori positivi per il conteggio dell'LBN e del settore corrispondente e FsRtlLookupLargeMcbEntry restituisce TRUE.
Se non esiste alcun mapping di questo tipo, ma la VBN specificata è inferiore alla più alta vbN mappata dal MCB, viene definita un foro nel mapping. In questo caso FsRtlLookupLargeMcbEntry restituisce comunque TRUE, ma l'operazione di ricerca restituisce un valore pari a -1 per LBN.
Se la vbN specificata è superiore al valore VBN più alto mappato da MCB o se mcB non contiene mapping, FsRtlLookupLargeMcbEntry restituisce FALSE.

I 32 bit superiori del LBN vengono ignorati. Vengono usati solo i 32 bit inferiori.