D3DDDIARG_CREATERESOURCE2 struttura (d3dukmdt.h)

Articolo
03/08/2023

Contiene informazioni per la creazione di una risorsa. Usato da Windows Display Driver Model (WDDM) 1.2 e versioni successive dei driver di visualizzazione in modalità utente.

Sintassi

typedef struct _D3DDDIARG_CREATERESOURCE2 {
  [in]     D3DDDIFORMAT                   Format;
  [in]     D3DDDI_POOL                    Pool;
  [in]     D3DDDIMULTISAMPLE_TYPE         MultisampleType;
  [in]     UINT                           MultisampleQuality;
  [in]     const D3DDDI_SURFACEINFO       *pSurfList;
  [in]     UINT                           SurfCount;
  [in]     UINT                           MipLevels;
  [in]     UINT                           Fvf;
  [in]     D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  [in]     D3DDDI_RATIONAL                RefreshRate;
  [in/out] HANDLE                         hResource;
  [in]     D3DDDI_RESOURCEFLAGS           Flags;
  [in]     D3DDDI_ROTATION                Rotation;
  [in]     D3DDDI_RESOURCEFLAGS2          Flags2;
} D3DDDIARG_CREATERESOURCE2;

Members

[in] Format

Valore di tipo D3DDDIFORMAT che indica il formato delle risorse.

[in] Pool

Valore di tipo D3DDDI_POOL che indica il tipo di pool di memoria creato dalle risorse.

[in] MultisampleType

Valore di tipo D3DDDIMULTISAMPLE_TYPE che indica il numero di campioni per una superficie a più campioni. Se la superficie non è più campione, questo valore è D3DDDIMULTISAMPLE_NONE (0).

[in] MultisampleQuality

Livello di qualità dei campioni di rendering in una superficie a più campioni. Il livello di qualità deve essere un numero compreso tra 0 e 7 che rappresenta rispettivamente un livello di qualità compreso tra 1 e 8.

Si noti che anche se la superficie non è a più campioni (ovvero, se D3DDDIMULTISAMPLE_NONE è specificata in MultisampleType) può comunque avere un livello di qualità maggiore di 1 (che viene specificato usando un numero maggiore di 0).

[in] pSurfList

Matrice di strutture D3DDDI_SURFACEINFO per l'elenco di superfici (o altri tipi di risorse) da creare.

[in] SurfCount

Numero di risorse nella matrice specificata dal membro pSurfList .

[in] MipLevels

Numero di livelli di mappa MIP per le risorse.

[in] Fvf

Formato FVF per i buffer dei vertici.

[in] VidPnSourceId

Numero di identificazione in base zero del video presente nell'origine in un percorso di una topologia di rete video presente (VidPN) in cui viene creata la superficie primaria (se la risorsa contiene una superficie primaria).

[in] RefreshRate

Struttura D3DDDI_RATIONAL che specifica la frequenza di aggiornamento utilizzata dalla risorsa. Questo membro è applicabile solo se la risorsa è la superficie primaria e il flag di campo bit-matchGdiPrimary non è impostato nel membro Flags . Inoltre, se il flag di campo a bit InterlacedRefresh è impostato in Flag, il driver di visualizzazione in modalità utente determina che la frequenza di aggiornamento viene interleaved (in caso contrario, progressiva).

[in/out] hResource

Handle alla risorsa. In input della funzione CreateResource2 hResource specifica l'handle che il driver deve usare in qualsiasi momento viene chiamato nel runtime di Microsoft Direct3D.

Il driver genera un handle univoco e lo passa al runtime Direct3D. Nell'output della funzione CreateResource2 hResource specifica l'handle che il runtime Direct3D deve usare nelle chiamate driver successive per identificare la risorsa.

[in] Flags

Struttura D3DDDI_RESOURCEFLAGS che identifica il tipo di risorse da creare. Si noti che alcuni flag di campo bit in D3DDDI_RESOURCEFLAGS richiedono che siano impostati anche flag di campo bit aggiuntivi.

[in] Rotation

Valore D3DDDI_ROTATION tipizzato che identifica l'orientamento della risorsa.

Si consideri ad esempio che il driver di visualizzazione in modalità utente riceve una richiesta per una superficie di 480x640 da ruotare a 90 gradi (D3DDDI_ROTATION_90). Il driver deve allocare la superficie in modalità 640x480 per scopi di analisi. Quando si esegue il rendering sulla superficie, il driver deve eseguire la rotazione di 90 gradi.

Gli orientamenti diversi da D3DDDI_ROTATION_IDENTITY vengono impostati solo quando il flag di campo a bit primario è impostato anche nel membro Flags .

[in] Flags2

Struttura D3DDDI_RESOURCEFLAGS2 che identifica il tipo di risorse da creare. Si noti che alcuni flag di campo a bit in D3DDDI_RESOURCEFLAGS2 richiedono che siano impostati anche flag di campo bit aggiuntivi.