estrutura CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT (ntifs.h)

A estrutura CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT contém o contexto de parâmetro de criação extra (ECP) que pode ser enviado ao sistema de arquivos CSV (Volumes Compartilhados Clusterizados) para definir propriedades de como ele deve lidar com a chegada de E/S nessa abertura.

Sintaxe

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;

Membros

Size

Tamanho dessa estrutura, em bytes.

PauseTimeoutInSeconds

O número de segundos em que o CSVFS tem permissão para manter a E/S emitida nesse objeto de arquivo em um estado pendente no caso de pausa de volume CSV. Depois que o tempo expirar, o CSV concluirá toda a E/S emitida neste objeto de arquivo com status STATUS_CSV_IO_PAUSE_TIMEOUT. Esse membro pode ser um dos valores a seguir.

Valor	Significado
0xFFFFFFFF	Indica que não há tempo limite e o comportamento padrão é solicitado.
0	O CSV não pausará a E/S e concluirá a E/S imediatamente.
Qualquer outro valor	O CSV reunirá todos os outros valores para um múltiplo de 10 segundos e usará esse valor como o tempo limite. O valor máximo de tempo limite com suporte é de 30 minutos. Se o valor fornecido for maior que 30 minutos, o CSV definirá silenciosamente o valor como o valor máximo.

Flags

Os sinalizadores de propriedade set. Esse membro pode ser um OR bit a bit dos sinalizadores a seguir.

Sinalizador	Significado
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR	Informa ao CSVFS que esse arquivo aberto deve ser válido somente no nó de coordenação. Se o open vier para CSVFS e o nó não for um nó de coordenação, o open falhará. Se o arquivo for aberto e o nó de coordenação for movido, o arquivo aberto será invalidado. Esse sinalizador é usado somente quando o arquivo é aberto diretamente no CSVFS e é ignorado quando o arquivo é aberto por SMB.

Os 16 bits inferiores de Flags são para sinalizadores que fariam com que a criação falhasse com STATUS_INVALID_PARAMETER se o CSV não os reconhecesse. Os 16 bits superiores são para sinalizadores que seriam silenciosamente ignorados se o CSVFS não soubesse como tratá-los.

Comentários

O valor de GUID_ECP_CSV_SET_HANDLE_PROPERTIES definido pelo sistema é usado com essa estrutura de contexto ECP ao chamar rotinas de suporte relacionadas ao ECP, como FltAllocateExtraCreateParameter e FsRtlRemoveExtraCreateParameter.

Consulte Introdução a parâmetros de criação extra para obter mais informações.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Cabeçalho	ntifs.h