Função StorPortAcquireSpinLockEx (storport.h)

A rotina StorPortAcquireSpinLockEx adquire o bloqueio de rotação especificado.

Sintaxe

ULONG StorPortAcquireSpinLockEx(
  PVOID             HwDeviceExtension,
  STOR_SPINLOCK     SpinLock,
  PVOID             LockContext,
  PSTOR_LOCK_HANDLE LockHandle
);

Parâmetros

HwDeviceExtension

[in] Ponteiro para a extensão de dispositivo de miniportor por adaptador.

SpinLock

[in] Especifica um valor de enumerador do tipo STOR_SPINLOCK que especifica o bloqueio de rotação a ser adquirido.

LockContext

[in] Um ponteiro para o objeto DPC para o qual o bloqueio será mantido se SpinLock estiver definido como DpcLock. Esse membro deverá ser NULL se SpinLock indicar um tipo de InterruptLock ou StartIoLock.

LockHandle

[entrada/saída] Um ponteiro para um buffer que, no retorno, conterá um identificador de bloqueio. Para liberar o bloqueio, o chamador deve passar esse identificador para a rotina StorPortReleaseSpinLock .

Retornar valor

StorPortAcquireSpinLockEx retornará STOR_STATUS_SUCCESS se o bloqueio de rotação for adquirido com êxito. Caso contrário, ele retornará um código status, como um dos seguintes:

Comentários

Os drivers de miniporta devem garantir que eles não tentem adquirir um bloqueio que já esteja mantido ou adquirir bloqueios em uma ordem incorreta. Qualquer um desses erros resultará em deadlock do sistema.

Determinados bloqueios são mantidos automaticamente pelo driver de porta antes de chamar as rotinas de retorno de chamada do driver de miniport. Para cada rotina de retorno de chamada do driver de miniporto, a tabela a seguir indica qual bloqueio o driver de porta adquire automaticamente antes de chamar a rotina de retorno de chamada.

Os bloqueios mantidos pela influência do driver de porta que bloqueia as rotinas de retorno de chamada têm permissão para adquirir, pois os bloqueios de rotação devem ser adquiridos na seguinte ordem:

• DPC ou StartIo
• Interrupção

Por exemplo, se o driver de porta adquirir o bloqueio de rotação de interrupção antes de chamar uma rotina de retorno de chamada, essa rotina de retorno de chamada não poderá mais adquirir o bloqueio de rotação DPC ou StartIo porque os bloqueios de rotação DPC e StartIo são de uma ordem menor do que o bloqueio de rotação de interrupção . Por outro lado, se o driver de porta adquirir o bloqueio de rotação StartIo antes de chamar uma rotina de retorno de chamada, essa rotina de retorno de chamada, quando executada, ainda poderá adquirir uma interrupção ou um bloqueio de rotação DPC .

A tabela a seguir indica quais bloqueios de rotação cada rotina de driver de miniporto pode adquirir. Nos casos em que a rotina do driver de miniporto deve obter o bloqueio de rotação StartIo e o bloqueio de rotação de interrupção , a rotina sempre deve adquirir o bloqueio de rotação StartIo primeiro.

Requisitos

Confira também

STOR_SPINLOCK

StorPortReleaseSpinLock