StorPortGetLogicalProcessorRelationship-Funktion (storport.h)

Die StorPortGetLogicalProcessorRelationship Routine ruft Informationen über die Beziehungen eines oder mehrerer Prozessoren zu den anderen Prozessoren in einem Multiprozessorsystem ab. Weitere Details 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 Hostbusadapter (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 einer oder mehrerer SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX Strukturen empfängt, die die vom Aufrufer angeforderten Informationen enthalten. Wenn die Funktion fehlschlägt, sind die Inhalte dieses Puffers nicht definiert. Legen Sie Information auf NULL fest, um die erforderliche Pufferlänge abzurufen, bevor Sie den Puffer zuweisen. Weitere Details finden Sie unter KeQueryLogicalProcessorRelationship.

[in, out] Length

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

Rückgabewert

Die StorPortGetLogicalProcessorRelationshipRoutine gibt 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 zu enthalten.
STOR_STATUS_INVALID_PARAMETER	Mindestens ein Parameter ist ungültig; Beispielsweise verweist ProcessNumber auf ungültige Informationen.
STOR_STATUS_NOT_IMPLEMENTED	Diese Funktion ist nicht auf dem aktiven Betriebssystem implementiert.

Bemerkungen

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

Weitere Details finden Sie unter KeQueryLogicalProcessorRelationship.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 7
Zielplattform-	Universal
Header-	storport.h (include Storport.h)
IRQL-	<=DISPATCH_LEVEL
DDI-Complianceregeln	StorPortIrql(storport)