StorPortGetSystemAddress, fonction (storport.h)

Article
02/26/2024

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 retournée

StorPortGetSystemAddress retourne l’un des codes status suivants :

Code de retour	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 status 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	La tentative de mapper la mémoire tampon de données à l’espace système a échoué.

Remarques

À compter 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 Function de Srb est SRB_FUNCTION_STORAGE_REQUEST_BLOCK, le SRB est une structure de requête STORAGE_REQUEST_BLOCK .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Cette routine est disponible à partir de Windows Server 2003 avec SP2.
Plateforme cible	Universal
En-tête	storport.h (inclure Storport.h)
IRQL	<=DISPATCH_LEVEL
Règles de conformité DDI	StorPortIrql(storport)

Voir aussi

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK

Partager via