PFND3DWDDM1_3DDI_GETMIPPACKING funzione di callback (d3d10umddi.h)

Per una determinata risorsa riquadri, restituisce il numero di mips compressi e il numero di riquadri necessari per archiviare tutti i mips compressi.

Sintassi

PFND3DWDDM1_3DDI_GETMIPPACKING Pfnd3dwddm13DdiGetmippacking;

void Pfnd3dwddm13DdiGetmippacking(
  D3D10DDI_HDEVICE hDevice,
  D3D10DDI_HRESOURCE hTiledResource,
  UINT *pNumPackedMips,
  UINT *pNumTilesForPackedMips
)
{...}

Parametri

hDevice

Handle per il dispositivo di visualizzazione (contesto grafico).

hTiledResource

Handle per la risorsa riquadri.

pNumPackedMips

Puntatore a una variabile che riceve il numero di mips che vengono compressi, per una determinata sezione di matrice, inclusi eventuali errori che non usano le forme di riquadro standard.

Se non esiste alcuna confezione, deve essere restituito un valore pari a zero.

pNumTilesForPackedMips

Puntatore a una variabile che riceve il numero di riquadri in cui si adattano gli errori compressi per una determinata sezione di matrice.

Questo parametro viene ignorato se *pNumPackedMips restituisce zero.

Valore restituito

nessuno

Osservazioni

Il driver può usare la funzione di callback pfnSetErrorCb per impostare un codice di errore. Il driver può impostare E_INVALIDARG se un parametro di input non esiste o è NULL.

I mips compressi includono casi in cui più piccoli mips condividono riquadri e anche mips per cui un determinato dispositivo non può usare forme di riquadro standard. È possibile che un'intera risorsa venga considerata confezionata.

Le applicazioni non hanno detto che le forme del riquadro o il layout per gli ip compressi devono semplicemente eseguire il mapping di tutti o nessuno dei riquadri compressi se uno dei mipmap deve essere accessibile. In caso contrario, il mapping osservato dei singoli pixel a cui è stato eseguito l'accesso non è definito e è specifico per il fornitore hardware indipendente (IHV).

Le mappe mipmap con dimensioni pixel che riempiono completamente almeno un riquadro a forma standard in tutte le dimensioni non possono essere considerati parte del set di mips compressi. In caso contrario, il runtime rimuoverà il dispositivo in un driver non valido.
Un esempio di dimensioni che un dispositivo può raggruppare in modo valido nei riquadri confezionato (ovvero l'IHV può usare la suddivisione di riquadri personalizzata) è un mip che è almeno un riquadro ampio ma minore di un riquadro alto. Idealmente, tuttavia, un dispositivo userebbe la suddivisione standard dei riquadri per questo caso (in modo che l'applicazione possa gestire i riquadri in modo standard). Se un dispositivo deve usare una tiling personalizzata, l'applicazione non viene detto qual è la suddivisione dei riquadri (solo il numero di riquadri coinvolti nella confezione complessiva) e quindi perde una certa libertà.

Requisiti

Vedi anche

pfnSetErrorCb