Partager via

structure CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT (ntifs.h)

  • Article

La structure CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT contient le contexte de paramètre de création supplémentaire (ECP) qui peut être envoyé au système de fichiers CSV (Cluster Shared Volumes) pour définir les propriétés de la façon dont elle doit gérer les E/S arrivant sur cette ouverture.

Syntaxe

typedef struct _CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT {
  SIZE_T Size;
  ULONG  PauseTimeoutInSeconds;
  ULONG  Flags;
} CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT, *PCSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT;

Membres

Size

Taille de cette structure, en octets.

PauseTimeoutInSeconds

Nombre de secondes pendant lesquelles CSVFS est autorisé à contenir les E/S émises sur cet objet de fichier dans un état en attente en cas de pause du volume CSV. Une fois l’expiration du fichier CSV terminée, toutes les E/S émises sur cet objet de fichier avec l’état STATUS_CSV_IO_PAUSE_TIMEOUT. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
0xFFFFFFFF Indique qu’il n’y a pas de délai d’expiration et que le comportement par défaut est demandé.
0 Le fichier CSV ne suspend pas les E/S et termine immédiatement les E/S.
Toute autre valeur CSV arrondit toutes les autres valeurs à un multiple de 10 secondes et utilise cette valeur comme délai d’expiration. La valeur maximale de délai d’expiration prise en charge est de 30 minutes. Si la valeur fournie est supérieure à 30 minutes, CSV définit silencieusement la valeur sur la valeur maximale.

Flags

Indicateurs de propriété set. Ce membre peut être une OR au niveau du bit des indicateurs suivants.

Drapeau Signification
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR Indique à CSVFS que ce fichier ouvert doit être valide uniquement sur le nœud de coordination. Si l’ouverture arrive à CSVFS et que le nœud n’est pas un nœud de coordination, l’ouverture échoue. Si le fichier est ouvert et que le nœud de coordination est déplacé, celui-ci est invalidé. Cet indicateur est utilisé uniquement lorsque le fichier est ouvert directement sur CSVFS et est ignoré lorsque le fichier est ouvert sur SMB.

Les 16 bits inférieurs des indicateurs de concernent les indicateurs qui entraîneraient l’échec de la création avec STATUS_INVALID_PARAMETER si CSV ne les reconnaît pas. Les 16 bits supérieurs sont destinés aux indicateurs qui seraient ignorés en mode silencieux si CSVFS ne sait pas comment les gérer.

Remarques

La valeur GUID_ECP_CSV_SET_HANDLE_PROPERTIES définie par le système est utilisée avec cette structure de contexte ECP lors de l’appel de routines de support ecP telles que FltAllocateExtraCreateParameter et FsRtlRemoveExtraCreateParameter.

Pour plus d’informations, consultez Présentation pour créer des paramètres supplémentaires.

Exigences

Exigence Valeur
client minimum pris en charge Windows 8
d’en-tête ntifs.h