Compartir a través de

Función StorPortGetLogicalProcessorRelationship (storport.h)

  • Artículo

La rutina StorPortGetLogicalProcessorRelationship obtiene información sobre las relaciones de uno o varios procesadores con los demás procesadores de un sistema multiprocesador. Consulte KeQueryLogicalProcessorRelationship para obtener más información.

Sintaxis

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

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

[in, optional] ProcessorNumber

Puntero opcional a un número de procesador para el que se devolverán las relaciones. Para solicitar información sobre todos los procesadores lógicos del sistema, establezca este parámetro en NULL.

[in] RelationshipType

Indica el tipo de relación que se va a devolver. Consulte KeQueryLogicalProcessorRelationship para obtener más información.

[out] Information

Puntero a un búfer asignado por el autor de la llamada que recibe una matriz de una o varias estructuras SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX que contienen la información solicitada por el autor de la llamada. Si se produce un error en la función, el contenido de este búfer no está definido. Establezca Información en NULL para obtener la longitud de búfer necesaria antes de asignar el búfer. Consulte KeQueryLogicalProcessorRelationship para obtener más información.

[in, out] Length

Puntero al tamaño del búfer de información, en bytes. En la entrada, Length contiene el tamaño del búfer asignado por el autor de la llamada al que apunta información . A la devolución, este valor recibe el número de bytes que se rellenan con información de relación.

Valor devuelto

La rutina StorPortGetLogicalProcessorRelationshipdevuelve STOR_STATUS_SUCCESS si la llamada se realiza correctamente. Entre los posibles valores devueltos de error se incluyen los siguientes.

Código devuelto Descripción
STOR_STATUS_BUFFER_TOO_SMALL El búfer proporcionado no es lo suficientemente grande como para contener la información solicitada.
STOR_STATUS_INVALID_PARAMETER Uno o varios de los parámetros no son válidos; por ejemplo, ProcessNumber apunta a información no válida.
STOR_STATUS_NOT_IMPLEMENTED Esta función no se implementa en el sistema operativo activo.

Comentarios

La información que se devuelve incluye máscaras de afinidad de procesador compuestas por procesadores lógicos en el sistema host. Estos procesadores lógicos comparten los tipos de relación especificados.

Consulte KeQueryLogicalProcessorRelationship para obtener más información.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7
Plataforma de destino Universal
Encabezado storport.h (incluya Storport.h)
IRQL <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI StorPortIrql(storport)