StorPortGetLogicalProcessorRelationship, fonction (storport.h)

Article
02/26/2024

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 à 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, Length contient la taille de la mémoire tampon allouée à l’appelant vers laquelle l’information pointe. Au retour, cette valeur reçoit le nombre d’octets qui sont remplis avec des informations de relation.

Valeur retournée

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

Code de retour	Description
STOR_STATUS_BUFFER_TOO_SMALL	La mémoire tampon fournie n’est pas assez 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é de 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 .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7
Plateforme cible	Universal
En-tête	storport.h (inclure Storport.h)
IRQL	<=DISPATCH_LEVEL
Règles de conformité DDI	StorPortIrql(storport)

Partager via