Funzione StorPortGetLogicalProcessorRelationship (storport.h)

Articolo
02/26/2024

La routine StorPortGetLogicalProcessorRelationship ottiene informazioni sulle relazioni di uno o più processori agli altri processori in un sistema multiprocessore. Per altre informazioni, vedere KeQueryLogicalProcessorRelationship .

Sintassi

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

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore del bus host (HBA).

[in, optional] ProcessorNumber

Puntatore facoltativo a un numero di processore per il quale devono essere restituite le relazioni. Per richiedere informazioni su tutti i processori logici nel sistema, impostare questo parametro su NULL.

[in] RelationshipType

Indica il tipo di relazione da restituire. Per informazioni dettagliate, vedere KeQueryLogicalProcessorRelationship .

[out] Information

Puntatore a un buffer allocato dal chiamante che riceve una matrice di una o più strutture SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX che contengono le informazioni richieste dal chiamante. Se la funzione ha esito negativo, il contenuto di questo buffer non è definito. Impostare Informazioni su NULL per ottenere la lunghezza del buffer necessaria prima di allocare il buffer. Per altre informazioni, vedere KeQueryLogicalProcessorRelationship .

[in, out] Length

Puntatore alle dimensioni del buffer delle informazioni, in byte. Nella voce lunghezza contiene le dimensioni del buffer allocato dal chiamante a cui punta Information . Al ritorno, questo valore riceve il numero di byte popolati con le informazioni sulla relazione.

Valore restituito

La routine StorPortGetLogicalProcessorRelationshiprestituisce STOR_STATUS_SUCCESS se la chiamata ha esito positivo. I valori restituiti degli errori possibili includono quanto segue.

Codice restituito	Descrizione
STOR_STATUS_BUFFER_TOO_SMALL	Il buffer fornito non è sufficiente per contenere le informazioni richieste.
STOR_STATUS_INVALID_PARAMETER	Uno o più parametri non sono validi; Ad esempio, ProcessNumber punta a informazioni non valide.
STOR_STATUS_NOT_IMPLEMENTED	Questa funzione non viene implementata nel sistema operativo attivo.

Commenti

Le informazioni restituite includono maschere di affinità processore composte dai processori logici nel sistema host. Questi processori logici condividono i tipi di relazione specificati.

Per altre informazioni, vedere KeQueryLogicalProcessorRelationship .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7
Piattaforma di destinazione	Universale
Intestazione	Storport.h (include Storport.h)
IRQL	<=DISPATCH_LEVEL
Regole di conformità DDI	StorPortIrql(storport)

Condividi tramite