Compartilhar via


IOCTL_MOUNTMGR_KEEP_LINKS_WHEN_OFFLINE IOCTL (mountmgr.h)

Essa IOCTL orienta o gerenciador de montagem a manter um link simbólico ativo depois que o gerenciador do Plug and Play receber uma notificação de que seu volume correspondente ficou offline. Quando o volume volta a ficar online, o gerenciador de montagem reatribui o link simbólico ao volume. Nenhum outro volume tem permissão para reivindicar o link simbólico enquanto seu proprietário original está offline.

Os clusters usam essa IOCTL para garantir que um nó possa continuar acessando um volume com a mesma letra da unidade, mesmo que o volume não esteja continuamente presente no sistema.

Código principal

IRP_MJ_DEVICE_CONTROL

Buffer de entrada

O cliente do gerenciador de montagem carrega a estrutura a seguir com o link simbólico que persistirá mesmo depois que seu volume for removido do sistema. A estrutura inicializada MOUNTMGR_TARGET_NAME é inserida no início do buffer em Irp-AssociatedIrp.SystemBuffer>.

Comprimento do buffer de entrada

Parameters.DeviceIoControl.InputBufferLength no local da pilha de E/S do IRP indica o tamanho, em bytes, do buffer de entrada, que deve ser maior ou igual a sizeof(MOUNTMGR_TARGET_NAME).

Buffer de saída

Nenhum.

Comprimento do buffer de saída

Nenhum.

Buffer de entrada/saída

N/D

Comprimento do buffer de entrada/saída

N/D

Bloco de status

Se a operação for bem-sucedida, o campo Status será definido como STATUS_SUCCESS.

O tamanho do buffer de entrada, indicado por InputBufferLength, deve ser grande o suficiente para manter a estrutura MOUNTMGR_TARGET_NAME e o nome do link simbólico que o segue. Se não for grande o suficiente, o campo Status será definido como STATUS_INVALID_PARAMETER.

Comentários

Para obter mais informações, consulte Suporte a solicitações do Mount Manager em um driver de classe de armazenamento.

Requisitos

Requisito Valor
Cabeçalho mountmgr.h (inclua Mountmgr.h)

Confira também

MOUNTMGR_TARGET_NAME