Função KeAcquireInStackQueuedSpinLockAtDpcLevel (wdm.h)
A rotina KeAcquireInStackQueuedSpinLockAtDpcLevel adquire um bloqueio de rotação enfileirado quando o chamador já está em execução em IRQL >= DISPATCH_LEVEL.
Sintaxe
void KeAcquireInStackQueuedSpinLockAtDpcLevel(
PKSPIN_LOCK SpinLock,
PKLOCK_QUEUE_HANDLE LockHandle
);
Parâmetros
SpinLock
[in, out] Especifica o bloqueio de rotação a ser adquirido. Esse parâmetro deve ter sido inicializado por uma chamada para a rotina KeInitializeSpinLock .
LockHandle
[out] Ponteiro para uma estrutura de KLOCK_QUEUE_HANDLE fornecida pelo chamador que a rotina pode usar para retornar o identificador da fila de bloqueio de rotação. Para liberar o bloqueio, o chamador passa esse valor para a rotina KeReleaseInStackQueuedSpinLockFromDpcLevel .
Retornar valor
Nenhum
Comentários
Para um driver em execução em IRQL >= DISPATCH_LEVEL, KeAcquireInStackQueuedSpinLockAtDpcLevel adquire um bloqueio de rotação como um bloqueio de rotação enfileirado. Para obter mais informações, consulte Bloqueios de rotação enfileirados. Para liberar o bloqueio de rotação, chame a rotina KeReleaseInStackQueuedSpinLockFromDpcLevel .
Os drivers que já estão em execução em um IRQL >= DISPATCH_LEVEL podem chamar essa rotina para adquirir o bloqueio de rotação na fila mais rapidamente. Caso contrário, use a rotina KeAcquireInStackQueuedSpinLock para adquirir o bloqueio de rotação.
Para um driver em execução no IRQL > DISPATCH_LEVEL, essa rotina adquire o bloqueio sem modificar o IRQL atual. Para um driver em execução em IRQL = DISPATCH_LEVEL, essa rotina melhora o desempenho adquirindo o bloqueio sem primeiro definir o IRQL como DISPATCH_LEVEL, o que, nesse caso, seria uma operação redundante.
Como os bloqueios de rotação comuns, os bloqueios de rotação enfileirados só devem ser usados em circunstâncias muito especiais. Para obter uma descrição de quando usar bloqueios de rotação, consulte KeAcquireSpinLock.
Os drivers não devem combinar chamadas para KeAcquireSpinLock e KeAcquireInStackQueuedSpinLock no mesmo bloqueio de rotação. Um bloqueio de rotação sempre deve ser adquirido ou liberado como um bloqueio de rotação enfileirado ou como um bloqueio de rotação comum.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP |
| Cabeçalho | wdm.h |
| IRQL | IRQL >= DISPATCH_LEVEL |
| Regras de conformidade da DDI | HwStorPortProhibitedDDIs(storport) |