estrutura FS_BPIO_RESULTS (ntifs.h)

Artigo
03/01/2024

A estrutura FS_BPIO_RESULTS define saídas específicas da operação BypassIO para operações de FS_BPIO_OP_ENABLE e FS_BPIO_OP_QUERY quando um driver está falhando na operação.

Sintaxe

typedef struct _FS_BPIO_RESULTS {
  NTSTATUS OpStatus;
  USHORT   FailingDriverNameLen;
  WCHAR    FailingDriverName[32];
  USHORT   FailureReasonLen;
  WCHAR    FailureReason[128];
} FS_BPIO_RESULTS, *PFS_BPIO_RESULTS;

Membros

OpStatus

Recebe um código NTSTATUS disponível para o chamador que identifica por que o driver com falha não pode dar suporte ao BypassIO para esse arquivo. Esse campo só deve ser definido pelo primeiro driver para falhar na solicitação de habilitação/consulta.

FailingDriverNameLen

Recebe o comprimento da cadeia de caracteres armazenada em FailDriverName, em caracteres.

FailingDriverName[32]

Recebe uma cadeia de caracteres que especifica o nome do driver que falhou na solicitação. Por motivos de diagnóstico, um driver deve armazenar seu nome quando falha em uma operação de FS_BPIO_OP_ENABLE ou FS_BPIO_OP_QUERY. O nome deve corresponder ao nome real do driver usado pelo sistema; por exemplo, ntfs.sys. Não há garantia de que essa cadeia de caracteres seja terminada em NULL.

FailureReasonLen

Recebe o comprimento da cadeia de caracteres armazenada em FailReason, em caracteres.

FailureReason[128]

Recebe uma cadeia de caracteres exclusiva e descritiva que descreve por que o driver vetou a solicitação de habilitação/consulta. Essa cadeia de caracteres é usada por motivos de diagnóstico e deve estar em inglês para que não precise ser localizada. Não há garantia de que essa cadeia de caracteres seja terminada em NULL.