feat(runtime): restore indexed Control provider query
Docs Deploy / Build and Deploy MkDocs (push) Successful in 37s

This commit is contained in:
Valentin Popov committed 2026-10-31 09:22:41 +04:00
1 parent 8c11e0f470
commit 3e3ab0e0c6
4 files changed
+313 -19

No files matched your search

+74
View File
@@ -1429,6 +1429,80 @@ key из поля устройства `+0x04`. Provider getter `FUN_1000dc40` (
строку `table + key*0x2c`; текущее type-1 значение находится по `+0x14` строки.
Индекс устройства и ключ provider row — разные значения с разными задачами.
#### Индексный Control getter: сырой селектор `0x400`
В той же сборке `Control.dll` с SHA-256
`bcb86318089028548a178b03a21accdce15df0cc85ddd91674cf3c2f55012c6e`
индексный query для `QueryInterface(0x204)` входит через слот `+0x18` vtable
`0x3d1b4`: `FUN_1002bb40` (RVA `0x2bb40`, `RET 8`, `ECX=owner+0x0c`, ordinal
устройства в `EDX`, selector и output pointer на стеке). При сыром selector
`0x400` функция попадает в ветвь RVA `0x2bc3c`.
Ветка получает provider pointer из `device+0x44`, отдельно читает provider key
из `device+0x04` и вызывает provider vtable slot `+0x0c` в режиме `1`, передавая
адрес ячейки selector как storage результата. После вызова значение переносится
в выходной `f32` caller-а; ветвь возвращает `AL=1` без проверки текущего
descriptor tag или factory tag.
Поле `device+0x44` указывает на provider interface `owner+0x04` с vtable
`0x3d254`; slot `+0x0c` ведёт к `FUN_1000dc40` (RVA `0x0dc40`). Getter
использует key для строки общей таблицы, а не ordinal устройства. Для валидной
строки selector `1` читает её текущее type-1 поле `+0x14` напрямую:
`0x400` поэтому не пересчитывает долю из amount и maximum и не умножает её на
коэффициент устройства, `M` или descriptor word. В Rust тот же маршрут выглядит
так:
```text
device = devices[device_index]
value = providers[device.key].current_type1_value
return Some(value)
```
Индекс устройства сначала выбирает запись, её key затем выбирает provider row;
этот indexed-вызов не является глобальным запросом `0x0f` и не является
metadata getter IID `0x16`. Проекция Rust принимает конечные нормальные значения
и точные `+0`/`-0`, сохраняя биты нулевого значения; остальные float-диапазоны и
недоступные table/key остаются типизированными ошибками. Native selector-cell
alias/fallback вне валидной записи provider не реализован: Rust не подставляет
для такого пути `0.0` или `None`.
Шесть изолированных вызовов оригинала проверяют именно этот валидный
indexed-вызов.
В каждом ordinal устройства равен `2`, а ключ provider равен `1`, `3` или `4`;
все значения строк различаются, поэтому ключ не совпадает с ordinal и не
подменяется соседней строкой.
| Вектор | Ordinal | Key | Raw output | AL |
| --- | ---: | ---: | ---: | ---: |
| Значение из корпуса `1.0` | 2 | 1 | `0x3f800000` | 1 |
| Доля `0.625` | 2 | 1 | `0x3f200000` | 1 |
| Отрицательное конечное `-2.5` | 2 | 3 | `0xc0200000` | 1 |
| `+0` | 2 | 1 | `0x00000000` | 1 |
| `-0` | 2 | 3 | `0x80000000` | 1 |
| Отличающаяся строка `0.0625` | 2 | 4 | `0x3d800000` | 1 |
Вектор `0.625` специально задаёт native word `device+0x50 = 0`; он всё равно
возвращает текущее поле provider. Таблица устройства, provider и остальные
строки были синтетическими, ограждёнными входами; исполнены оригинальные
`FUN_1002bb40` и provider getter `FUN_1000dc40`, без constructors, ControlSystem
или mock callbacks. Все входные записи остались неизменными, проверены canary
области, а изменился только DWORD выхода. Для DLL с SHA-256
`bcb86318089028548a178b03a21accdce15df0cc85ddd91674cf3c2f55012c6e` входной
control word `0x027f` был временно заменён на `0x007f` и восстановлен после
вызова; у всех шести ветвей `AL=1`. Выходы совпали с прямыми значениями выбранных
synthetic rows. Это не снимок состояния оригинальной фабрики или миссии: полный
IID `0x204`, интеграция Behavior и gameplay-трасса не проверены.
Независимый разбор лицензированного AutoDemo дал восемь таблиц и 100 пар
устройство/key, но все выбранные type-1 значения там равны `1.0`. Такой набор
проверяет загрузку таблицы, ключи и доступность запросов, но не позволяет
различить выбор строки по key и по ordinal. Игнорируемый Rust acceptance test
проверяет все 100 запросов на этом корпусе и ожидает `0x3f800000`. В тесте явно
заданы `MissionStartupInput { queue_time_ms: 100_000,
research_creation_gate: false }`; эти значения являются входами Rust-проверки,
а не доказательством штатного gate оригинала. Native синтетические строки дают
отдельное доказательство выбора key. Оба результата имеют ограниченную область
и не являются сравнением полного поведения игры.
Конструктор owner `FUN_10006bf0` (RVA `0x6bf0`) задаёт scalar `+0x1a8 = 1.0`
и вызывает `FUN_10014260`, который записывает `1.0` в `+0x354/+0x358`.
Проверенные ветви канонического event `4/null` и FAC0 не меняют эти три поля