Função FltIsVolumeWritable (fltkernel.h)

Artigo
02/06/2025

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 por chamador que recebe VERDADEIRO se o volume for gravável; false caso contrário.

Valor de retorno

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.

Observações

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

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

Requisitos

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

Consulte também

IOCTL_DISK_IS_WRITABLE

Compartilhar via