Função IoAcquireVpbSpinLock (ntifs.h)

  • Artigo

A rotina IoAcquireVpbSpinLock adquire o bloqueio de rotação VPB (Bloco de Parâmetros de Volume).

Sintaxe

void IoAcquireVpbSpinLock(
  [out] PKIRQL Irql
);

Parâmetros

[out] Irql

Ponteiro para uma variável alocada por chamador na qual salvar o IRQL atual para uma chamada subsequente para IoReleaseVpbSpinLock. Normalmente, o Irql é salvo na pilha como uma variável local.

Retornar valor

Nenhum

Comentários

Os sistemas de arquivos chamam IoAcquireVpbSpinLock para adquirir o bloqueio de rotação do VPB. Esse bloqueio de rotação global deve ser adquirido antes de acessar qualquer um dos seguintes campos de um VPB:

  • Sinalizadores (especificamente, VPB_MOUNTED)

  • DeviceObject

  • RealDevice

  • ReferenceCount

Cada chamada bem-sucedida para IoAcquireVpbSpinLock deve ser correspondida por uma chamada subsequente para IoReleaseVpbSpinLock. Para evitar deadlock, o detentor do bloqueio de rotação do VPB deve liberá-lo imediatamente quando não for mais necessário.

Antes de usar IoAcquireVpbSpinLock e IoReleaseVpbSpinLock, os gravadores de driver são fortemente incentivados a estudar a maneira como essas rotinas são usadas na amostra FASTFAT.

Depois de chamar IoAcquireVpbSpinLock, o chamador é executado em IRQL DISPATCH_LEVEL. Chamar IoReleaseVpbSpinLock restaura o IRQL original do chamador.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI HwStorPortProhibitedDDIs(storport)

Confira também

IoReleaseVpbSpinLock