Fungsi StorPortGetLogicalProcessorRelationship (storport.h)

  • Artikel

Rutinitas StorPortGetLogicalProcessorRelationship mendapatkan informasi tentang hubungan satu atau beberapa prosesor dengan prosesor lain dalam sistem multiprosesor. Lihat KeQueryLogicalProcessorRelationship untuk detail tambahan.

Sintaks

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

Penunjuk ke ekstensi perangkat keras untuk adaptor bus host (HBA).

[in, optional] ProcessorNumber

Penunjuk opsional ke nomor prosesor yang hubungannya akan dikembalikan. Untuk meminta informasi tentang semua prosesor logis dalam sistem, atur parameter ini ke NULL.

[in] RelationshipType

Menunjukkan jenis hubungan yang akan dikembalikan. Lihat KeQueryLogicalProcessorRelationship untuk detailnya.

[out] Information

Penunjuk ke buffer yang dialokasikan penelepon yang menerima array dari satu atau beberapa struktur SYSTEM_LOGICAL_PROCESSOR_INFORMATION_EX yang berisi informasi yang diminta oleh pemanggil. Jika fungsi gagal, konten buffer ini tidak terdefinisi. Atur Informasi ke NULL untuk mendapatkan panjang buffer yang diperlukan sebelum Anda mengalokasikan buffer. Lihat KeQueryLogicalProcessorRelationship untuk detail tambahan.

[in, out] Length

Penunjuk ke ukuran buffer informasi, dalam byte. Pada entri, Panjang berisi ukuran buffer yang dialokasikan pemanggil yang dituju informasi . Saat dikembalikan, nilai ini menerima jumlah byte yang diisi dengan informasi hubungan.

Nilai kembali

Rutinitas StorPortGetLogicalProcessorRelationshipmengembalikan STOR_STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan mencakup yang berikut ini.

Menampilkan kode Deskripsi
STOR_STATUS_BUFFER_TOO_SMALL Buffer yang disediakan tidak cukup besar untuk menyimpan informasi yang diminta.
STOR_STATUS_INVALID_PARAMETER Satu atau beberapa parameter tidak valid; misalnya, ProcessNumber menunjuk ke informasi yang tidak valid.
STOR_STATUS_NOT_IMPLEMENTED Fungsi ini tidak diimplementasikan pada sistem operasi aktif.

Keterangan

Informasi yang dikembalikan mencakup masker afinitas prosesor yang terdiri dari prosesor logis dalam sistem host. Prosesor logis ini berbagi jenis hubungan yang ditentukan.

Lihat KeQueryLogicalProcessorRelationship untuk detail tambahan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7
Target Platform Universal
Header storport.h (termasuk Storport.h)
IRQL <=DISPATCH_LEVEL
Aturan kepatuhan DDI StorPortIrql(storport)