DXGKDDI_RELEASESWIZZLINGRANGE funzione di callback (d3dkmddi.h)
La funzione DxgkDdiReleaseSwizzlingRange rilascia un intervallo swizzling configurato in precedenza dalla funzione DxgkDdiAcquireSwizzlingRange .
Sintassi
DXGKDDI_RELEASESWIZZLINGRANGE DxgkddiReleaseswizzlingrange;
NTSTATUS DxgkddiReleaseswizzlingrange(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_RELEASESWIZZLINGRANGE pReleaseSwizzlingRange
)
{...}
Parametri
[in] hAdapter
Handle di un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport di visualizzazione fornito in precedenza questo handle al sottosistema kernel della grafica Microsoft DirectX nel parametro di output MiniportDeviceContext della funzione DxgkDdiAddDevice .
[in] pReleaseSwizzlingRange
Puntatore a una struttura DXGKARG_RELEASESWIZZLINGRANGE che contiene informazioni per il rilascio dell'intervallo di scorrimento.
Valore restituito
DxgkDdiReleaseSwizzlingRange restituisce STATUS_SUCCESS o un risultato di errore appropriato se l'intervallo di scorrimento rapido non viene rilasciato correttamente.
Commenti
La funzione DxgkDdiReleaseSwizzlingRange viene in genere chiamata quando l'allocazione specificata (ovvero il membro hAllocation della struttura DXGKARG_RELEASESWIZZLINGRANGE a cui punta il parametro pReleaseSwizzlingRange ) viene rimossa o eliminata definitivamente oppure quando un'altra allocazione richiede l'intervallo di scorrimento specificato dal membro RangeId di DXGKARG_RELEASESWIZZLINGRANGE.
Se l'allocazione specificata è attualmente associata a più intervalli swizzling (tramite chiamate alla funzione DxgkDdiAcquireSwizzlingRange ), il driver miniport di visualizzazione deve rilasciare solo l'intervallo di scorrimento che il membro RangeId di DXGKARG_RELEASESWIZZLINGRANGE specifica. Se il driver miniport di visualizzazione rilascia tutti gli intervalli di scorrimento associati all'allocazione, il danneggiamento casuale nell'allocazione potrebbe risultare perché un'applicazione potrebbe attualmente usare uno o più intervalli di scorrimento.
Il driver deve usare I/O mappato alla memoria (MMIO) per configurare un intervallo di scorrimento. Questi accessi con intervallo di scorrimento non devono interferire con l'esecuzione della GPU, ovvero la GPU non deve essere inattiva quando viene chiamato DxgkDdiReleaseSwizzlingRange .
Tutte le chiamate a DxgkDdiReleaseSwizzlingRange vengono serializzate tra loro, ma non con altre funzioni DDI (Device Driver Interface).
DxgkDdiReleaseSwizzlingRange deve essere reso pageable.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Piattaforma di destinazione | Desktop |
| Intestazione | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |