Função FltIsVolumeWritable (fltkernel.h)

  • Artigo

A rotina FltIsVolumeWritable determina se o dispositivo de disco que corresponde a uma instância de driver de volume ou minifiltro é gravável.

Sintaxe

NTSTATUS FLTAPI FltIsVolumeWritable(
  [in]  PVOID    FltObject,
  [out] PBOOLEAN IsWritable
);

Parâmetros

[in] FltObject

Um ponteiro opaco para o volume ou instância. Lembre-se de que o volume associado deve ser um volume do sistema de arquivos local.

[out] IsWritable

Um ponteiro para uma variável booliana alocada pelo chamador que receberá TRUE se o volume for gravável; Caso contrário, FALSE.

Retornar valor

FltIsVolumeWritable retorna STATUS_SUCCESS ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno Descrição
STATUS_INSUFFICIENT_RESOURCES
 FltIsVolumeWritable encontrou uma falha de alocação de memória. Este é um código de erro.
STATUS_INVALID_DEVICE_REQUEST
 O dispositivo de disco não dá suporte a solicitações de IOCTL_DISK_IS_WRITABLE. Este é um código de erro.

Comentários

FltIsVolumeWritable envia uma solicitação de IOCTL_DISK_IS_WRITABLE para o dispositivo de armazenamento subjacente associado ao volume ou instância fornecido.

Em versões do Windows anteriores ao Windows Vista, a rotina FltIsVolumeWritable aceitava apenas volumes, não instâncias.

Requisitos

Requisito Valor
Cliente mínimo com suporte A rotina FltIsVolumeWritable está disponível no Windows Vista e em versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho fltkernel.h (inclua Fltkernel.h)
Biblioteca Fltmgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Confira também

IOCTL_DISK_IS_WRITABLE