structure FS_BPIO_RESULTS (ntifs.h)

  • Article

La structure FS_BPIO_RESULTS définit des sorties spécifiques à l’opération BypassIO pour les opérations FS_BPIO_OP_ENABLE et FS_BPIO_OP_QUERY lorsqu’un pilote échoue.

Syntaxe

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

Membres

OpStatus

Reçoit un code NTSTATUS disponible pour l’appelant qui identifie pourquoi le pilote défaillant ne peut pas prendre en charge BypassIO pour ce fichier. Ce champ doit uniquement être défini par le premier pilote pour que la requête d’activation/requête échoue.

FailingDriverNameLen

Reçoit la longueur de la chaîne stockée dans FailingDriverName, en caractères.

FailingDriverName[32]

Reçoit une chaîne qui spécifie le nom du pilote qui a échoué la demande. Pour des raisons de diagnostic, un pilote doit stocker son nom lorsqu’il échoue à une opération FS_BPIO_OP_ENABLE ou FS_BPIO_OP_QUERY. Le nom doit correspondre au nom réel du pilote utilisé par le système ; par exemple, ntfs.sys. Il n’est pas garanti que cette chaîne se termine par null.

FailureReasonLen

Reçoit la longueur de la chaîne stockée dans FailingReason, en caractères.

FailureReason[128]

Reçoit une chaîne descriptive unique décrivant la raison pour laquelle le pilote a opposé son veto à la demande d’activation/requête. Cette chaîne est utilisée pour des raisons de diagnostic et doit être en anglais afin qu’elle n’ait pas besoin d’être localisée. Il n’est pas garanti que cette chaîne se termine par null.

Remarques

FS_BPIO_RESULTS est retourné dans la structure FS_BPIO_OPERATIONS lorsqu’un pilote échoue à une opération d’activation ou de requête BypassIO.

Pour plus d’informations, consultez BypassIO pour les pilotes de filtre et Prise en charge des opérations BypassIO .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 11
En-tête ntifs.h

Voir aussi

FS_BPIO_OPERATIONS

FSCTL_MANAGE_BYPASS_IO