Função FltIsIoRedirectionAllowed (fltkernel.h)

A rotina FltIsIoRedirectionAllowed determina se a E/S pode ser redirecionada da instância de filtro de origem especificada para outra instância de filtro especificada.

Sintaxe

NTSTATUS FLTAPI FltIsIoRedirectionAllowed(
  [in]  PFLT_INSTANCE SourceInstance,
  [in]  PFLT_INSTANCE TargetInstance,
  [out] PBOOLEAN      RedirectionAllowed
);

Parâmetros

[in] SourceInstance

A instância de filtro na pilha do dispositivo de origem.

[in] TargetInstance

A instância de filtro na pilha do dispositivo de destino.

[out] RedirectionAllowed

Um valor true se toda a E/S para a pilha do dispositivo de origem puder ser redirecionada para a pilha de dispositivos de destino alterando a instância de filtro referenciada, caso contrário, FALSE.

Retornar valor

Um valor NTSTATUS de STATUS_SUCCESS para êxito ou STATUS_NOT_SUPPORTED se não houver suporte para redirecionamento.

Comentários

Uma operação de E/S está associada a uma estrutura de FLT_CALLBACK_DATA . Essa estrutura contém uma referência a um objeto PFLT_IO_PARAMETER_BLOCK , que contém uma referência à FLT_INSTANCE do minifiltro associado à operação de E/S.

Se RedirectionAllowed for TRUE, o minifiltro poderá redirecionar E/S alterando essa instância para uma nova instância de destino.

Se RedirectionAllowed for FALSE, o minifiltro precisará alocar um novo objeto de dados de retorno de chamada para emitir E/S na pilha de destino ou chamar FltAdjustDeviceStackSizeForIoRedirection para aumentar o tamanho da pilha do dispositivo de origem.

Nota Os minifiltros não devem modificar a referência ao FLT_INSTANCE antes de verificar se o redirecionamento pode ser feito dessa maneira. Use FltIsIoRedirectionAllowedForOperation ou FltIsIoRedirectionAllowed.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 7 e versões posteriores do sistema operacional Windows.
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua FltKernel.h)
Biblioteca FltMgr.lib
DLL Fltmgr.sys
IRQL <=DISPATCH_LEVEL

Confira também

FLT_CALLBACK_DATA

FLT_IO_PARAMETER_BLOCK

FltAdjustDeviceStackSizeForIoRedirection

FltIsIoRedirectionAllowedForOperation