StorPortGetLogicalProcessorRelationship-Funktion (storport.h)

Artikel
08/07/2023

Die StorPortGetLogicalProcessorRelationship-Routine ruft Informationen zu den Beziehungen eines oder mehrerer Prozessoren zu den anderen Prozessoren in einem Multiprozessorsystem ab. Weitere Informationen finden Sie unter KeQueryLogicalProcessorRelationship .

Syntax

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
);

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung für den Host Bus Adapter (HBA).

[in, optional] ProcessorNumber

Ein optionaler Zeiger auf eine Prozessornummer , für die Beziehungen zurückgegeben werden sollen. Um Informationen zu allen logischen Prozessoren im System anzufordern, legen Sie diesen Parameter auf NULL fest.

[in] RelationshipType

Gibt den Typ der zurückzugebenden Beziehung an. Weitere Informationen finden Sie unter KeQueryLogicalProcessorRelationship .

[out] Information

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der ein Array aus einer oder mehreren SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX Strukturen empfängt, die die vom Aufrufer angeforderten Informationen enthalten. Wenn die Funktion fehlschlägt, ist der Inhalt dieses Puffers undefiniert. Legen Sie Informationen auf NULL fest, um die erforderliche Pufferlänge abzurufen, bevor Sie den Puffer zuordnen. Weitere Informationen finden Sie unter KeQueryLogicalProcessorRelationship .

[in, out] Length

Ein Zeiger auf die Größe des Informationspuffers in Bytes. Beim Eintrag enthält Length die Größe des vom Aufrufer zugewiesenen Puffers, auf den Information verweist. Bei der Rückgabe empfängt dieser Wert die Anzahl der Bytes, die mit Beziehungsinformationen aufgefüllt werden.

Rückgabewert

Die StorPortGetLogicalProcessorRelationship-Routinegibt STOR_STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Mögliche Fehlerrückgabewerte sind:

Rückgabecode	Beschreibung
STOR_STATUS_BUFFER_TOO_SMALL	Der bereitgestellte Puffer ist nicht groß genug, um die angeforderten Informationen aufzunehmen.
STOR_STATUS_INVALID_PARAMETER	Mindestens ein Parameter ist ungültig. Beispielsweise verweist ProcessNumber auf ungültige Informationen.
STOR_STATUS_NOT_IMPLEMENTED	Diese Funktion ist auf dem aktiven Betriebssystem nicht implementiert.

Hinweise

Die zurückgegebenen Informationen umfassen Prozessoraffinitätsmasken, die aus den logischen Prozessoren im Hostsystem bestehen. Diese logischen Prozessoren verwenden die angegebenen Beziehungstypen.

Weitere Informationen finden Sie unter KeQueryLogicalProcessorRelationship .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7
Zielplattform	Universell
Header	storport.h (einschließlich Storport.h)
IRQL	<=DISPATCH_LEVEL
DDI-Complianceregeln	StorPortIrql(storport)

Freigeben über