Funzione MmUnlockPagableImageSection (wdm.h)
La routine MmUnlockPagableImageSection rilascia una sezione dei dati del driver o del driver, precedentemente bloccata nello spazio di sistema con MmLockPagableCodeSection, MmLockPagableDataSection o MmLockPagableSectionByHandle, in modo che la sezione possa essere nuovamente ripaginata.
Sintassi
void MmUnlockPagableImageSection(
[in] PVOID ImageSectionHandle
);
Parametri
[in] ImageSectionHandle
Specifica l'handle restituito da una chiamata a MmLockPagableCodeSection o MmLockPagableDataSection.
Valore restituito
Nessuno
Osservazioni
L'handle per la sezione visualizzabile di un driver non deve essere rilasciato se il driver dispone di irP in sospeso nelle code dei dispositivi o nelle code interne. Una chiamata a MmUnlockPagableImageSection ripristina la paginabilità dell'intera sezione quando non sono presenti altri riferimenti all'handle per tale sezione.
Gestione memoria mantiene il conteggio dei riferimenti sull'handle di una sezione. Una sezione pageable è disponibile solo per il paging quando il conteggio dei riferimenti è zero. Ogni richiesta di blocco incrementa il conteggio; ogni richiesta di sblocco decrementa il conteggio. Un driver deve sbloccare una sezione tutte le volte in cui blocca una sezione per rendere disponibile la sezione per la pagina.
Un handle è sempre valido, indipendentemente dal conteggio. Se il conteggio su un handle è zero e viene effettuata una chiamata a MmLockPagableSectionByHandle, il conteggio è impostato su uno e, se la sezione è stata inserita in pagine, verrà visualizzata una pagina in.
Nella maggior parte dei casi, mmUnlockPagableImageSection prima della routine scaricamento di un driver. Ciò significa che è probabile che un driver con una sezione impaginabile abbia DispatchClose e/o DispatchShutdown chiamata di routine MmUnlockPagableImageSe ction prima che venga chiamata la routine unload. Tuttavia, è necessario prestare attenzione a scaricare i driver per rilasciare qualsiasi sezione impaginabile prima che il driver stesso venga scaricato dal sistema.
Per altre informazioni sul paging di codice e dati, vedere Rendere i driver impaginabili.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 2000. |
| piattaforma di destinazione | Universale |
| intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | <=APC_LEVEL |
| regole di conformità DDI | HwStorPortProhibitedDDIs(storport), IrqlMmApcLte(wdm) |