§ ˜M­j,ãóî—dZddlZddlZddlZddlmZmZ ddlZdZn#e $rdZdZYnwxYwdZ dZ Gd„d ej ¦«Z d ed eefd „Zd efd „Zd eefd„Zded efd„Zded efd„ZdS)uÁThÆ° viện dùng chung quản lý tiến trình Win32 cho Path of Exile 2. Cung cấp các hàm kiểm tra trạng thái hoạt Ä‘á»™ng, trích xuất Process ID (PID) và tìm kiếm tiến trình theo tên thá»±c thi. Há»— trợ cả thÆ° viện psutil và Win32 Toolhelp32 Snapshot API vá»›i cÆ¡ chế giải phóng tài nguyên triệt để trong khối finally. Tuân thủ nghiêm ngặt chuẩn tài liệu Google Docstrings theo Rule 16. éN)ÚListÚOptionalTF)zpathofexile.exezpathofexilesteam.exezpathofexile_x64.exezpathofexile_x64steam.exezpathofexile2.exeéc ó—eZdZdejjfdejjfdejjfdejej¦«fdejjfdejjfdejjfdejfd ejjfd ej d zfg Z d S) Ú_PROCESSENTRY32WÚdwSizeÚcntUsageÚ th32ProcessIDÚth32DefaultHeapIDÚ th32ModuleIDÚ cntThreadsÚth32ParentProcessIDÚpcPriClassBaseÚdwFlagsÚ szExeFileiN) Ú__name__Ú __module__Ú __qualname__ÚctypesÚwintypesÚDWORDÚPOINTERÚc_ulongÚc_longÚc_wcharÚ_fields_©óú0C:\Projects\AutoPOE2\src\common\win32_process.pyrr sŸ€€€€€à 6”?Ô(Ð)Ø V”_Ô*Ð+Ø ˜&œ/Ô/Ð0Ø ˜n˜fœn¨V¬^Ñ<Ô<Ð=Ø ˜œÔ.Ð/Ø v”Ô,Ð-Ø  ¤Ô 5Ð6Ø ˜6œ=Ð)Ø F”OÔ)Ð*Ø f”n sÑ*Ð+ð €H€H€HrrÚnameÚreturncó—| ¦«}g}tË tjddg¦«D]¡} |j d¦«}|rV| ¦«|kr>|j d¦«}|"| t |¦«¦«Œv#tjtjtj f$rYŒžwxYw|S#t$rYnwxYwtj dkrLtjj}| t"d¦«}tj d¦«j}|rú||krô t+¦«} tjt*¦«| _| |tj| ¦«¦«ro | j ¦«|kr'| t | j¦«¦«| |tj| ¦«¦«snŒn| |¦«n#| |¦«wxYw|S)u4Tìm danh sách Process ID (PID) của tất cả tiến trình có tên tệp thá»±c thi khá»›p vá»›i tên chỉ định. So sánh không phân biệt hoa thÆ°á»ng. Ưu tiên kiểm tra nhanh qua psutil nếu có sẵn, và tá»± Ä‘á»™ng chuyển sang Windows Toolhelp32 API nếu psutil chÆ°a cài đặt hoặc gặp sá»± cố. Äảm bảo giải phóng handle snapshot trong khối finally. Args: name: Tên tệp thá»±c thi cần tìm (ví dụ: 'PathOfExile.exe'). Returns: List[int]: Danh sách các PID Ä‘ang chạy khá»›p vá»›i tên chỉ định. Trả vá» rá»—ng nếu không tìm thấy. Thread-safety: Thread-safe. Example: >>> pids = find_process_by_name("PathOfExile.exe") >>> print(f"Tìm thấy {len(pids)} tiến trình.") NÚpidr Úntréÿÿÿÿ)ÚlowerÚpsutilÚ process_iterÚinfoÚgetÚappendÚintÚ NoSuchProcessÚ AccessDeniedÚ ZombieProcessÚ ExceptionÚosr rÚwindllÚkernel32ÚCreateToolhelp32SnapshotÚTH32CS_SNAPPROCESSrÚHANDLEÚvaluerÚsizeofrÚProcess32FirstWÚbyrefrr ÚProcess32NextWÚ CloseHandle) r Ú target_nameÚ found_pidsÚprocÚpnamer#r3Ú h_snapshotÚinvalid_handleÚpe32s rÚfind_process_by_namerD/s8€ð(—*’*‘,”,€KØ€JõÐð ÝÔ+¨U°F¨OÑ<Ô<ð ð ðØ œIŸMšM¨&Ñ1Ô1EØð8 §¢¡¤°+Ò!=Ð!=Ø"œiŸmšm¨EÑ2Ô2˜Ø˜?Ø&×-Ò-­c°#©h¬hÑ7Ô7Ð7øøÝÔ,­fÔ.AÅ6ÔCWÐXðððØHðøøøàÐ øÝð ð ð Ø ˆDð øøøõ „w$‚Ý”=Ô)ˆØ×6Ò6Õ7IÈ1ÑMÔMˆ Ýœ×/Ò/°Ñ3Ô3Ô9ˆØ ð 1˜*¨Ò6Ð6ð 1Ý'Ñ)Ô)Ý$œmÕ,<Ñ=Ô=” Ø×+Ò+¨J½¼ ÀTÑ8JÔ8JÑKÔKð"ð"Øœ>×/Ò/Ñ1Ô1°[Ò@Ð@Ø&×-Ò-­c°$Ô2DÑ.EÔ.EÑFÔFÐFØ'×6Ò6°zÅ6Ä<ÐPTÑCUÔCUÑVÔVð"Ø!ð "ð ×$Ò$ ZÑ0Ô0Ð0Ð0ø×$Ò$ ZÑ0Ô0Ð0Ð0øøøà ÐsBŸC¸A2B+Â*CÂ+&CÃCÃCÃCà C&Ã%C&ÅCH,È,Icó"—t¦«duS)uðKiểm tra xem tiến trình game Path of Exile 2 có Ä‘ang hoạt Ä‘á»™ng trên hệ thống hay không. Quét đối chiếu toàn bá»™ các tên tệp thá»±c thi phổ biến của POE2 (Standalone, Steam, x64). Returns: bool: True nếu phát hiện ít nhất má»™t tiến trình POE2 Ä‘ang chạy, ngược lại False. Thread-safety: Thread-safe. Example: >>> if is_poe2_running(): ... print("Client POE2 Ä‘ang hoạt Ä‘á»™ng.") N)Ú get_poe2_pidrrrÚis_poe2_runningrGks€õ ‰>Œ> Ð %Ð%rcóP—tD]}t|¦«}|r |dcSŒdS)u÷Lấy Process ID (PID) của tiến trình Path of Exile 2 Ä‘ang chạy. Tìm kiếm tuần tá»± qua danh sách các tên tệp thá»±c thi hợp lệ và trả vá» PID đầu tiên được tìm thấy. Returns: Optional[int]: PID của tiến trình POE2 nếu Ä‘ang chạy, hoặc None nếu không tìm thấy. Thread-safety: Thread-safe. Example: >>> pid = get_poe2_pid() >>> if pid is not None: ... print(f"POE2 PID: {pid}") rN)ÚPOE2_PROCESS_NAMESrD)Ú proc_nameÚpidss rrFrF}s?€õ"(ððˆ Ý# IÑ.Ô.ˆØ ð ؘ”7ˆNˆNˆNð à ˆ4rr#có—|r|dkrdStP tj|¦«}| ¦«}|r| ¦«Sn#t$rYnwxYwt jdkrd}t jj}|  |d|¦«}|rê t j d¦«}t j   d¦«}|  |d|t j|¦«¦«rKt j |j¦« ¦«| |¦«Sn#t$rYnwxYw| |¦«n#| |¦«wxYwdS)uìLấy tên tệp thá»±c thi (lowercase) của tiến trình từ Process ID (PID). Ưu tiên tra cứu qua psutil nếu có sẵn, và tá»± Ä‘á»™ng fallback vá» Win32 QueryFullProcessImageNameW (PROCESS_QUERY_LIMITED_INFORMATION) không cần quyá»n Admin. Args: pid: Process ID cần kiểm tra. Returns: str: Tên tệp thá»±c thi dạng chữ thÆ°á»ng (ví dụ: 'pathofexile.exe'), hoặc chuá»—i rá»—ng. Thread-safety: Thread-safe. rÚNr$iFi)r'ÚProcessr r&r0r1rr2r3Ú OpenProcessÚcreate_unicode_bufferrrÚQueryFullProcessImageNameWr:ÚpathÚbasenamer7r<)r#Úpr Ú!PROCESS_QUERY_LIMITED_INFORMATIONr3Úh_procÚbufÚsizes rÚget_process_name_by_pidrY•s£€ð ð#˜’((؈rõÐð Ý”˜sÑ#Ô#ˆAØ—6’6‘8”8ˆDØð $Ø—z’z‘|”|Ð#ð $øåð ð ð Ø ˆDð øøøõ „w$‚Ø,2Ð)Ý”=Ô)ˆØ×%Ò%Ð&GÈÐPSÑTÔTˆØ ð -ð -ÝÔ2°3Ñ7Ô7Ý”×,Ò,¨SÑ1Ô1Ø×6Ò6°v¸qÀ#ÅvÄ|ÐTXÑGYÔGYÑZÔZð?Ýœ7×+Ò+¨C¬IÑ6Ô6×<Ò<Ñ>Ô>ð×$Ò$ VÑ,Ô,Ð,Ð,ð ?øåð ð ð Øð øøøð×$Ò$ VÑ,Ô,Ð,Ð,ø×$Ò$ VÑ,Ô,Ð,Ð,øøøà ˆ2s<“=AÁ AÁA BE ÅE/Å EÅE/ÅEÅE/Å/FcóB—t|¦«}|sdS|tvpd|vS)uxKiểm tra xem Process ID (PID) có thuá»™c vá» tiến trình game Path of Exile 2 hay không. Äối chiếu tên tệp thá»±c thi vá»›i POE2_PROCESS_NAMES hoặc chuá»—i 'pathofexile'. Args: pid: Process ID cần kiểm tra. Returns: bool: True nếu là tiến trình POE2, ngược lại False. Thread-safety: Thread-safe. FÚ pathofexile)rYrI)r#r s rÚ is_poe2_pidr\Äs4€õ # 3Ñ 'Ô '€DØ ð؈uØ Õ%Ð %Ð >¨¸$Ð)>Ð>r)Ú__doc__rÚctypes.wintypesr1Útypingrrr'Ú _HAS_PSUTILÚ ImportErrorrIr5Ú StructurerÚstrr,rDÚboolrGrFrYr\rrrúresrðððð€ € € ØÐÐÐØ € € € Ø!Ð!Ð!Ð!Ð!Ð!Ð!Ð!ðØ€M€M€MØ€K€KøØðððØ €FØ€K€K€KðøøøðÐð Ðð ð ð ð ð vÔ'ñ ô ð ð9˜sð9 t¨C¤yð9ð9ð9ð9ðx&˜ð&ð&ð&ð&ð$h˜s”mððððð0, ð,¨ð,ð,ð,ð,ð^?Sð?˜Tð?ð?ð?ð?ð?ð?s ˜Ÿ +ª+