Funzione StorPortAcquireSpinLock (storport.h)

La routine StorPortAcquireSpinLock acquisisce il blocco di selezione specificato.

Sintassi

void StorPortAcquireSpinLock(
  [in]     PVOID             DeviceExtension,
  [in]     STOR_SPINLOCK     SpinLock,
  [in]     PVOID             LockContext,
  [in/out] PSTOR_LOCK_HANDLE LockHandle
);

Parametri

[in] DeviceExtension

Puntatore all'estensione del dispositivo miniport driver per adattatore.

[in] SpinLock

Specifica un valore enumeratore di tipo STOR_SPINLOCK che specifica il blocco spin da acquisire. Per questa funzione, SpinLock deve essere uno di: DpcLock, StartIoLock o InterruptLock. Chiamare StorportAcquireSpinLockEx per acquisire altri tipi di blocchi di selezione.

[in] LockContext

Puntatore all'oggetto DPC per il quale viene mantenuto il blocco se SpinLock è impostato su DpcLock. Questo membro deve essere NULL se SpinLock indica un tipo di InterruptLock o StartIoLock.

[in/out] LockHandle

Puntatore a un buffer che, al momento della restituzione, conterrà un handle di blocco. Per rilasciare il blocco, il chiamante deve passare questo handle alla routine StorPortReleaseSpinLock .

Valore restituito

nessuno

Osservazioni

I driver Miniport devono assicurarsi che non tentino di acquisire un blocco già mantenuto o acquisire blocchi in un ordine non corretto. Uno di questi errori comporterà un deadlock del sistema.

Alcuni blocchi vengono mantenuti automaticamente dal driver della porta prima di chiamare le routine di callback del driver miniport. Per ogni routine di callback del driver miniport, la tabella seguente indica il blocco che il driver della porta acquisisce automaticamente prima di chiamare la routine di callback.

I blocchi mantenuti dal driver di porta influiscono sui blocchi che bloccano le routine di callback possono acquisire, perché i blocchi di rotazione devono essere acquisiti nell'ordine seguente:

• DPC o StartIo
• Interrompere

Ad esempio, se il driver della porta acquisisce il blocco di rotazione Interrupt prima di chiamare una routine di callback, tale routine di callback non può più acquisire il blocco di rotazione DPC o StartIo perché i blocchi di rotazione DPC e StartIo sono di un ordine inferiore rispetto al blocco di rotazione Interrupt. D'altra parte, se il driver della porta acquisisce il blocco spin StartIo prima di chiamare una routine di callback, tale routine di callback, quando eseguita, potrebbe comunque acquisire un interrupt o un blocco di rotazione DPC .

La tabella seguente indica i blocchi di rotazione che ogni routine del driver miniport può acquisire. In quei casi in cui la routine del driver miniport deve ottenere sia il blocco di rotazione StartIo che il blocco di rotazione Interrupt , la routine deve sempre acquisire il blocco di rotazione StartIo per primo.

Requisiti

Vedi anche

STOR_SPINLOCK

StorPortReleaseSpinLock