Funzione StorPortGetLogicalProcessorRelationship (storport.h)

  • Articolo

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)