Metodo ID3D11Device::CreateTexture1D (d3d11.h)
Crea una matrice di trame 1D.
Sintassi
HRESULT CreateTexture1D(
[in] const D3D11_TEXTURE1D_DESC *pDesc,
[in, optional] const D3D11_SUBRESOURCE_DATA *pInitialData,
[out, optional] ID3D11Texture1D **ppTexture1D
);
Parametri
[in] pDesc
Tipo: const D3D11_TEXTURE1D_DESC*
Puntatore a una struttura D3D11_TEXTURE1D_DESC che descrive una risorsa trama 1D. Per creare una risorsa senza tipi che può essere interpretata in fase di esecuzione in formati compatibili diversi, specificare un formato senza tipi nella descrizione della trama. Per generare automaticamente livelli mipmap, impostare il numero di livelli mipmap su 0.
[in, optional] pInitialData
Tipo: const D3D11_SUBRESOURCE_DATA*
Puntatore a una matrice di strutture D3D11_SUBRESOURCE_DATA che descrivono le sottorisorse per la risorsa trama 1D. Le applicazioni non possono specificare NULL per pInitialData durante la creazione di risorse IMMUTABLE (vedere D3D11_USAGE). Se la risorsa è multicampionata, pInitialData deve essere NULL perché le risorse multicampionamento non possono essere inizializzate con i dati al momento della creazione.
Se non si passa alcun elemento a pInitialData, il contenuto iniziale della memoria per la risorsa non è definito. In questo caso, è necessario scrivere il contenuto della risorsa in altro modo prima che la risorsa venga letta.
È possibile determinare le dimensioni di questa matrice dai valori nei membri MipLevels e ArraySize della struttura D3D11_TEXTURE1D_DESC a cui pDesc punta utilizzando il calcolo seguente:
MipLevels * ArraySize
Per altre informazioni su questa dimensione della matrice, vedere Osservazioni.
[out, optional] ppTexture1D
Tipo: ID3D11Texture1D**
Puntatore a un buffer che riceve un puntatore a un'interfaccia ID3D11Texture1D per la trama creata. Impostare questo parametro su NULL per convalidare gli altri parametri di input. Il metodo restituirà S_FALSE se gli altri parametri di input superano la convalida.
Valore restituito
Tipo: HRESULT
Se il metodo ha esito positivo, il codice restituito viene S_OK. Vedere Codici restituiti Direct3D 11 per i codici di errore non riusciti.
Commenti
CreateTexture1D crea una risorsa trama 1D, che può contenere una serie di sottorisorse 1D. Il numero di trame viene specificato nella descrizione della trama. Tutte le trame in una risorsa devono avere lo stesso formato, dimensioni e numero di livelli mipmap.
Tutte le risorse sono costituite da una o più sottorisorse. Per caricare i dati nella trama, le applicazioni possono fornire inizialmente i dati come matrice di strutture D3D11_SUBRESOURCE_DATA a cui punta pInitialData oppure possono usare una delle funzioni di trama D3DX, ad esempio D3DX11CreateTextureFromFile.
Per una trama di 32 larghezza con una catena mipmap completa, la matrice pInitialData ha i 6 elementi seguenti:
- pInitialData[0] = 32x1
- pInitialData[1] = 16x1
- pInitialData[2] = 8x1
- pInitialData[3] = 4x1
- pInitialData[4] = 2x1
- pInitialData[5] = 1x1
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | d3d11.h |
| Libreria | D3D11.lib |