Função FltGetFilterInformation (fltkernel.h)
A rotina FltGetFilterInformation fornece informações sobre um driver de minifiltro.
Sintaxe
NTSTATUS FLTAPI FltGetFilterInformation(
[in] PFLT_FILTER Filter,
[in] FILTER_INFORMATION_CLASS InformationClass,
[out] PVOID Buffer,
[in] ULONG BufferSize,
[out] PULONG BytesReturned
);
Parâmetros
[in] Filter
Ponteiro de filtro opaco para o chamador.
[in] InformationClass
Tipo de informação solicitada. Esse parâmetro pode ter um dos valores a seguir.
| Valor | Significado |
|---|---|
| FilterFullInformation | O buffer apontado pelo parâmetro Buffer recebe uma estrutura de FILTER_FULL_INFORMATION para o driver de minifiltro. |
| FilterAggregateBasicInformation | O buffer apontado pelo parâmetro do Buffer de recebe uma estrutura FILTER_AGGREGATE_BASIC_INFORMATION para o driver de minifiltro. Esse valor InformationClass está disponível a partir do Microsoft Windows Server 2003 SP1 e do Windows XP SP2 com rollup do gerenciador de filtros. Para obter mais informações sobre o pacote cumulativo do gerenciador de filtros para Windows XP SP2, consulte o artigo 914882" O pacote cumulativo do gerenciador de filtros para o Windows XP SP2", na Base de Dados de Conhecimento da Microsoft. |
| FilterAggregateStandardInformation | O buffer apontado pelo parâmetro Buffer recebe uma estrutura de FILTER_AGGREGATE_STANDARD_INFORMATION para o driver de minifiltro. A parte LegacyFilter da estrutura não é utilizada. Esse valor InformationClass está disponível a partir do Windows Vista. |
[out] Buffer
Ponteiro para um buffer alocado por chamador que recebe as informações solicitadas. O tipo das informações retornadas no buffer é definido pelo parâmetro InformationClass.
[in] BufferSize
Tamanho, em bytes, do buffer ao qual o Buffer parâmetro aponta. O chamador deve definir esse parâmetro de acordo com o valor informationClass fornecido.
[out] BytesReturned
Ponteiro para uma variável alocada por chamador que recebe o número de bytes retornados no buffer para o qual Buffer aponta. Se o valor de entrada de BufferSize for muito pequeno, FltGetFilterInformation retornará STATUS_BUFFER_TOO_SMALL e definirá essa variável para o número de bytes necessários para armazenar as informações solicitadas. Esse parâmetro é necessário e não pode ser NULL.
Valor de retorno
FltGetFilterInformation retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:
| Código de retorno | Descrição |
|---|---|
|
O buffer ao qual o buffer de aponta não é grande o suficiente para armazenar as informações solicitadas. Este é um código de erro. |
|
Um valor inválido foi especificado para o parâmetro InformationClass. Por exemplo, se FilterAggregateStandardInformation for especificado em um sistema operacional antes do Windows Vista, a rotina retornará STATUS_INVALID_PARAMETER. Este é um código de erro. |
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| cabeçalho | fltkernel.h (inclua FltKernel.h) |
| biblioteca | FltMgr.lib |
| de DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |
Consulte também
FILTER_AGGREGATE_BASIC_INFORMATION
FILTER_AGGREGATE_STANDARD_INFORMATION
FltEnumerateInstanceInformationByFilter