CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT structure (ntifs.h)
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 Volumes partagés de cluster (CSV) pour définir les propriétés de la façon dont il 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é à conserver les E/S émises sur cet objet fichier dans un état en attente en cas de pause du volume CSV. Une fois le délai d’expiration expiré, LE CSV termine toutes les E/S émises sur cet objet de fichier avec status 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 | Csv ne suspend pas les E/S et termine les E/S immédiatement. |
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 de délai d’expiration maximale 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 un or au niveau du bit des indicateurs suivants.
Indicateur | 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é, le fichier ouvert 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 d’indicateurs sont destinés aux 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 silencieusement si CSVFS ne sait pas comment les gérer.
Remarques
La valeur de 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 prise en charge liées à ECP telles que FltAllocateExtraCreateParameter et FsRtlRemoveExtraCreateParameter.
Pour plus d’informations, consultez Présentation des paramètres de création supplémentaires .
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 8 |
En-tête | ntifs.h |