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 precedentemente fornito questo handle al sottosistema kernel della grafica Microsoft DirectX nel MiniportDeviceContext parametro di output della funzione DxgkDdiAddDevice.
[in] pReleaseSwizzlingRange
Puntatore a una struttura DXGKARG_RELEASESWIZZLINGRANGE che contiene informazioni per rilasciare l'intervallo di scorrimento.
Valore restituito
DxgkDdiReleaseSwizzlingRange restituisce STATUS_SUCCESS o un risultato di errore appropriato se l'intervallo di scorrimento non viene rilasciato correttamente.
Osservazioni
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) o quando un'altra allocazione richiede l'intervallo di scorrimento che il RangeId membro di DXGKARG_RELEASESWIZZLINGRANGE specifica.
Se l'allocazione specificata è attualmente associata a più intervalli swizzling (tramite chiamate al DxgkDdiAcquireSwizzlingRange funzione), il driver miniport di visualizzazione deve rilasciare solo l'intervallo swizzling specificato dal RangeId membro di DXGKARG_RELEASESWIZZLINGRANGE. Se il driver miniport di visualizzazione rilascia tutti gli intervalli di scorrimento associati all'allocazione, il danneggiamento casuale nell'allocazione potrebbe comportare l'uso di uno o più intervalli di scorrimento.
Il driver deve usare l'I/O mappato alla memoria (MMIO) per configurare un intervallo swizzling. Questi accessi swizzling-range 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 qualsiasi altra funzione DDI (Device Driver Interface).
dxgkDdiReleaseSwizzlingRange deve essere reso pageable.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |