struktur POOL_EXTENDED_PARAMETER (wdm.h)

  • Artikel

Menentukan informasi parameter yang diperluas yang disediakan driver saat memanggil ExAllocatePool3.

Sintaks

typedef struct _POOL_EXTENDED_PARAMETER {
  struct {
    ULONG64 Type : POOL_EXTENDED_PARAMETER_TYPE_BITS;
    ULONG64 Optional : POOL_EXTENDED_PARAMETER_REQUIRED_FIELD_BITS;
    ULONG64 Reserved : POOL_EXTENDED_PARAMETER_RESERVED_BITS;
  } DUMMYSTRUCTNAME;
  union {
    ULONG64                          Reserved2;
    PVOID                            Reserved3;
    EX_POOL_PRIORITY                 Priority;
    POOL_EXTENDED_PARAMS_SECURE_POOL *SecurePoolParams;
    POOL_NODE_REQUIREMENT            PreferredNode;
  } DUMMYUNIONNAME;
} POOL_EXTENDED_PARAMETER, *PPOOL_EXTENDED_PARAMETER;

Anggota

DUMMYSTRUCTNAME

DUMMYSTRUCTNAME.Type

Nilai enumerasi POOL_EXTENDED_PARAMETER_TYPE yang menunjukkan jenis parameter.

Jika nilai ini diatur ke PoolExtendedParameterPriority, maka anggota Prioritas dari struktur ini harus menjadi nilai EX_POOL_PRIORITY yang menunjukkan prioritas alokasi kumpulan. Jika tidak ada cukup ruang untuk prioritas yang ditentukan, alokasi gagal.

DUMMYSTRUCTNAME.Optional

Jika bidang ini diatur ke 1, parameter yang diperluas bersifat opsional. Jika Type bukan nilai enumerasi yang valid, maka akan diabaikan. Jika Type adalah enumerasi yang valid, itu mungkin masih diabaikan, misalnya jika tidak kompatibel dengan bendera tertentu lainnya.

Jika bidang ini diatur ke 0, Jenis harus dikenali oleh alokator kumpulan atau alokasi gagal.

DUMMYSTRUCTNAME.Reserved

Disiapkan untuk penggunaan masa mendatang.

DUMMYUNIONNAME

DUMMYUNIONNAME.Reserved2

DUMMYUNIONNAME.Reserved3

DUMMYUNIONNAME.Priority

Jika Jenis diatur ke PoolExtendedParameterPriority, bidang ini harus berisi nilai EX_POOL_PRIORITY yang valid.

DUMMYUNIONNAME.SecurePoolParams

DUMMYUNIONNAME.PreferredNode

Jika Jenis diatur ke PoolExtendedParameterNumaNode , bidang ini harus berisi indeks simpul NUMA yang valid bernomor 0 hingga N-1. Jika bidang juga berisi MM_ANY_NODE_OK, panggilan lebih memilih simpul NUMA yang ditentukan tetapi mencoba yang lain jika tidak tersedia. Jika MM_ANY_NODE_OK tidak diatur, panggilan gagal jika simpul NUMA yang diminta tidak dapat memenuhi alokasi. Parameter ini hanya valid untuk alokasi yang dibuat dengan kumpulan POOL_FLAG_NON_PAGED.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, version 2004
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)

Lihat juga

POOL_EXTENDED_PARAMETER_TYPE

ExAllocatePool3