StorPortGetSystemAddress, fonction (storport.h)

Article
02/07/2025

La routine StorPortGetSystemAddress retourne une adresse virtuelle dans l’espace système pour la mémoire tampon de données du bloc de requête SCSI (SRB) spécifié.

Syntaxe

ULONG StorPortGetSystemAddress(
  [in]  PVOID               HwDeviceExtension,
  [in]  PSCSI_REQUEST_BLOCK Srb,
  [out] PVOID               *SystemAddress
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).

[in] Srb

Pointeur vers une structure SCSI_REQUEST_BLOCK.

[out] SystemAddress

Pointeur pour recevoir l’adresse virtuelle de la mémoire tampon de données.

Valeur de retour

StorPortGetSystemAddress retourne l’un des codes d’état suivants :

Retourner le code	Description
STOR_STATUS_NOT_IMPLEMENTED	Cette fonction n’est pas implémentée sur le système d’exploitation actif.
STOR_STATUS_SUCCESS	Indique que l’adresse système a été obtenue avec succès.
STOR_STATUS_INVALID_PARAMETER	Ce code d’état est dû à l’une des conditions suivantes : Le SRB n’a pas de mémoire tampon de données associée. Le pointeur pour recevoir l’adresse virtuelle est NULL.
STOR_STATUS_INVALID_IRQL	L’appel a été effectué à un IRQL non valide.
STOR_STATUS_INSUFFICIENT_RESOURCES	Échec de la tentative de mappage de la mémoire tampon de données à l’espace système.

Remarques

À partir de Windows 8, le paramètre Srb peut pointer vers SCSI_REQUEST_BLOCK ou STORAGE_REQUEST_BLOCK. Si l’identificateur de fonction dans le champ fonction de Srb est SRB_FUNCTION_STORAGE_REQUEST_BLOCK, le SRB est une structure de requête STORAGE_REQUEST_BLOCK.

Exigences

Exigence	Valeur
client minimum pris en charge	Cette routine est disponible à partir de Windows Server 2003 avec SP2.
plateforme cible	Universel
d’en-tête	storport.h (include Storport.h)
IRQL	<=DISPATCH_LEVEL
règles de conformité DDI	StorPortIrql(storport)

Voir aussi

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK

Partager via