Compartilhar via


IOCTL_VOLUME_ONLINE IOCTL (ntddvol.h)

O IOCTL_VOLUME_ONLINE IOCTL coloca o volume em um estado ONLINE, que é um estado em que as operações de leitura e gravação serão executadas. As solicitações são passadas para o disco físico até que um IOCTL_VOLUME_OFFLINE subsequente seja recebido.

Um uso comum para IOCTL_VOLUME_ONLINE é um caso em que o gerenciador de montagem coloca automaticamente um novo volume no estado ONLINE quando o volume chega, a menos que esse volume esteja listado em uma chave do Registro preenchida pelo serviço de cluster. IOCTL_VOLUME_ONLINE é chamado para unidades removíveis, independentemente da configuração NoAutoMount na seguinte chave do Registro:

HKCU\System\CurrentControlSet\Services\Mountmgr\NoAutoMount

Mas para volumes controlados pelo NoAutoMount, atribuir uma letra da unidade fará com que IOCTL_VOLUME_ONLINE sejam chamados.

Para volumes controlados pelo serviço de cluster, IOCTL_VOLUME_ONLINE é enviado pelo serviço de cluster quando o nó local possui o volume. O serviço de cluster usa IOCTL_VOLUME_ONLINE e IOCTL_VOLUME_ONLINE para permitir E/S para um volume de disco quando o volume de disco pertence ao servidor local. Até que o serviço de cluster coloque o volume de disco em um estado ONLINE, nenhuma E/S é permitida para o volume de disco. Isso impede a corrupção de volume de disco que pode resultar de vários nós de cluster gravando simultaneamente no mesmo volume de disco.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

Nenhum.

Comprimento do buffer de entrada

Nenhum.

Buffer de saída

Nenhum.

Comprimento do buffer de saída

Nenhum.

Bloco de status

O membro Status é definido como STATUS_SUCCESS.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows XP.
Cabeçalho ntddvol.h (inclua Ntddvol.h)

Confira também

IOCTL_VOLUME_OFFLINE