Fungsi RxCreateMidAtlas (midatlax.h)

Artikel
02/29/2024

RxCreateMidAtlas mengalokasikan instans baru struktur data MID_ATLAS dan menginisialisasinya.

Sintaks

PRX_MID_ATLAS RxCreateMidAtlas(
  USHORT MaximumNumberOfEntries,
  USHORT InitialAllocation
);

Parameter

MaximumNumberOfEntries

Jumlah maksimum ID multipleks (MID) yang akan diizinkan di atlas.

InitialAllocation

Jumlah ID multipleks yang dialokasikan pada awalnya.

Nilai kembali

RxCreateMidAtlas mengembalikan pointer untuk dialokasikan dan diinisialisasi MID_ATLAS struktur data pada keberhasilan atau pointer NULL gagal.

Keterangan

RDBSS mendefinisikan ID Multipleks (MID), nilai 16-bit, yang dapat digunakan oleh klien jaringan (mini-redirector) dan server untuk membedakan antara permintaan yang aktif secara bersamaan pada koneksi apa pun.

MID harus secara efisien dapat mengelola penandaan dan identifikasi unik dari sejumlah MIT (biasanya 50) dari kombinasi yang mungkin dari 65.536 nilai. Untuk memastikan tradeoff ruang waktu yang tepat, pencarian diatur sebagai hierarki tiga tingkat. 16 bit yang digunakan untuk mewakili MID dibagi menjadi tiga bitfield. Panjang bidang paling kanan (paling tidak signifikan ) diputuskan oleh jumlah maksimum MIT yang akan diizinkan dalam atlas. Nilai maksimum ini adalah parameter yang diteruskan ke RxCreateMidAtlas saat struktur data MID_ATLAS dibuat. Panjang yang tersisa dibagi rata antara dua bidang berikutnya.

Misalnya, jika maksimum 50 MID akan dialokasikan pada pembuatan , panjang bidang pertama adalah 6 (64 ( 2 ** 6 ) lebih besar dari 50 ). Panjang yang tersisa dibagi menjadi dua bidang masing-masing 5 bit.

RxCreateMidAtlas mengalokasikan memori kumpulan non-halaman saat membuat struktur data MID_ATLAS baru.