Función StorPortAcquireMSISpinLock (storport.h)

La rutina StorPortAcquireMSISpinLock adquiere el bloqueo de giro de interrupción señalizado (MSI) del mensaje asociado al mensaje especificado.

Sintaxis

ULONG StorPortAcquireMSISpinLock(
  [in] PVOID  HwDeviceExtension,
       ULONG  MessageId,
  [in] PULONG OldIrql
);

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

MessageId

Identificador del mensaje cuyo bloqueo de número adquiere el autor de la llamada.

[in] OldIrql

Puntero al almacenamiento del valor IRQL original que se usará en una llamada posterior a StorPortReleaseMSISpinLock.

Valor devuelto

storPortAcquireMSISpinLock devuelve uno de los siguientes valores:

Código devuelto Descripción
STOR_STATUS_NOT_IMPLEMENTED Esta función no se implementa en el sistema operativo activo.
STOR_STATUS_SUCCESS Indica que el bloqueo de número se adquirió correctamente.
STOR_STATUS_INVALID_PARAMETER El HwDeviceExtension de era NULL.

Observaciones

Un controlador de minipuerto llama a la rutina StorPortAcquireMSISpinLock para adquirir el bloqueo de número MSI para un mensaje determinado. Para liberar el bloqueo de giro, el controlador de miniporta llama a la rutina storPortReleaseMSISpinLock. Esta rutina la usan los controladores de miniporte para adquirir un bloqueo de número MSI para un mensaje individual solo cuando el InterruptSynchronizationMode miembro de la estructura de PORT_CONFIGURATION_INFORMATION se establece en InterruptSynchronizePerMessage.

Cuando un miniporte necesita sincronizarse con todos los mensajes, puede usar una llamada a StorPortAcquireSpinLock que adquirirá un bloqueo para cada mensaje en el orden adecuado.

Requisitos

Requisito Valor
cliente mínimo admitido Esta rutina está disponible a partir de Windows Vista.
de la plataforma de destino de Universal
encabezado de storport.h (incluya Storport.h)
irQL Cualquier nivel

Consulte también

PORT_CONFIGURATION_INFORMATION

storPortAcquireSpinLock

StorPortReleaseMSISpinLock