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 |