Função FltCompareInstanceAltitudes (fltkernel.h)

Artigo
02/26/2024

FltCompareInstanceAltitudes compara as altitudes de duas instâncias de driver de minifiltro.

Sintaxe

LONG FLTAPI FltCompareInstanceAltitudes(
  [in] PFLT_INSTANCE Instance1,
  [in] PFLT_INSTANCE Instance2
);

Parâmetros

[in] Instance1

Ponteiro para a primeira instância.

[in] Instance2

Ponteiro para a segunda instância.

Retornar valor

FltCompareInstanceAltitudes retorna um valor assinado que fornece os resultados da comparação da seguinte maneira:

Código de retorno	Descrição
Zero	Instance1 é anexado na mesma altitude que Instance2. Isso só poderá ocorrer se Instance1 e Instance2 estiverem anexados a volumes diferentes ou se Instance1 e Instance2 forem ponteiros para a mesma instância.
Menor que zero	Instance1 é anexado a uma altitude menor que Instance2.
Maior que zero	Instance1 é anexado a uma altitude mais alta do que Instance2.

Comentários

As instâncias de driver de minifiltro para as quais Instance1 e Instance2 apontam podem ser instâncias do mesmo driver de minifiltro ou drivers de minifiltro diferentes. No entanto, eles deverão ser anexados ao mesmo volume se o resultado retornado por FltCompareInstanceAltitudes for significativo.

O termo "altitude" refere-se à posição que uma instância ocupa (ou deve ocupar) na pilha de instâncias do driver de minifiltro para um volume. Quanto maior a altitude, mais distante a instância fica do sistema de arquivos base na pilha. Somente uma instância pode ser anexada a uma determinada altitude em um determinado volume.

Altitude é especificada por uma cadeia de caracteres de altitude, que é uma cadeia de caracteres Unicode contada que consiste em um ou mais dígitos decimais de 0 a 9; a cadeia de caracteres pode incluir um único ponto decimal. Por exemplo, "100.123456" e "03333" são cadeias de caracteres de altitude válidas.

A cadeia de caracteres "03333" representa uma altitude maior que "100,123456" (zeros à esquerda e à direita são ignorados.) Em outras palavras, uma instância cuja altitude é "03333" está mais distante do sistema de arquivos base do que uma instância cuja altitude é "100,123456". No entanto, essa comparação só será significativa se ambas as instâncias estiverem anexadas ao mesmo volume.

Para anexar uma instância de driver de minifiltro a um volume, chame FltAttachVolume ou FltAttachVolumeAtAltitude.

Para desanexar uma instância de driver de minifiltro de um volume, chame FltDetachVolume.