Función StorPortAcquireMSISpinLock (storport.h)

La rutina StorPortAcquireMSISpinLock adquiere el bloqueo de número 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	HwDeviceExtension era NULL.

Comentarios

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 número, el controlador de minipuerto 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 miembro InterruptSynchronizationMode de la estructura PORT_CONFIGURATION_INFORMATION está establecido en InterruptSynchronizePerMessage.

Cuando una 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	Value
Cliente mínimo compatible	Esta rutina está disponible a partir de Windows Vista.
Plataforma de destino	Universal
Encabezado	storport.h (incluya Storport.h)
IRQL	Cualquier nivel

Consulte también

PORT_CONFIGURATION_INFORMATION

StorPortAcquireSpinLock

StorPortReleaseMSISpinLock