Fungsi StorPortGetLogicalProcessorRelationship (storport.h)
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) |