StorPortGetLogicalProcessorRelationship, fonction (storport.h)

Article
02/07/2025

La routine StorPortGetLogicalProcessorRelationship obtient des informations sur les relations d’un ou de plusieurs processeurs avec les autres processeurs dans un système multiprocesseur. Pour plus d’informations, consultez KeQueryLogicalProcessorRelationship.

Syntaxe

ULONG StorPortGetLogicalProcessorRelationship(
  [in]           PVOID                                    HwDeviceExtension,
  [in, optional] PPROCESSOR_NUMBER                        ProcessorNumber,
  [in]           LOGICAL_PROCESSOR_RELATIONSHIP           RelationshipType,
  [out]          PSYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX Information,
  [in, out]      PULONG                                   Length
);

Paramètres

[in] HwDeviceExtension

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

[in, optional] ProcessorNumber

Pointeur facultatif vers un numéro de processeur pour lequel les relations doivent être retournées. Pour demander des informations sur tous les processeurs logiques du système, définissez ce paramètre sur NULL.

[in] RelationshipType

Indique le type de relation à retourner. Pour plus d’informations, consultez KeQueryLogicalProcessorRelationship.

[out] Information

Pointeur vers une mémoire tampon allouée par l’appelant qui reçoit un tableau d’une ou plusieurs structures SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX qui contiennent les informations demandées par l’appelant. Si la fonction échoue, le contenu de cette mémoire tampon n’est pas défini. Définissez Informations sur NULL pour obtenir la longueur de mémoire tampon requise avant d’allouer la mémoire tampon. Pour plus d’informations, consultez KeQueryLogicalProcessorRelationship.

[in, out] Length

Pointeur vers la taille de la mémoire tampon d’informations, en octets. Lors de l’entrée, Longueur contient la taille de la mémoire tampon allouée par l’appelant qui Informations pointe vers. Lors du retour, cette valeur reçoit le nombre d’octets renseignés avec des informations de relation.

Valeur de retour

La routine StorPortGetLogicalProcessorRelationshipretourne STOR_STATUS_SUCCESS si l’appel réussit. Les valeurs de retour d’erreur possibles sont les suivantes.

Retourner le code	Description
STOR_STATUS_BUFFER_TOO_SMALL	La mémoire tampon fournie n’est pas suffisamment grande pour contenir les informations demandées.
STOR_STATUS_INVALID_PARAMETER	Un ou plusieurs des paramètres ne sont pas valides ; par exemple, ProcessNumber pointe vers des informations non valides.
STOR_STATUS_NOT_IMPLEMENTED	Cette fonction n’est pas implémentée sur le système d’exploitation actif.

Remarques

Les informations retournées incluent des masques d’affinité du processeur composés des processeurs logiques dans le système hôte. Ces processeurs logiques partagent les types de relation spécifiés.

Pour plus d’informations, consultez KeQueryLogicalProcessorRelationship.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 7
plateforme cible	Universel
d’en-tête	storport.h (include Storport.h)
IRQL	<=DISPATCH_LEVEL
règles de conformité DDI	StorPortIrql(storport)

Partager via