PFND3D11DDI_CREATERESOURCE funzione di callback (d3d10umddi.h)

Articolo
02/06/2025

Crea una risorsa.

Sintassi

PFND3D11DDI_CREATERESOURCE Pfnd3d11ddiCreateresource;

void Pfnd3d11ddiCreateresource(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D11DDIARG_CREATERESOURCE *unnamedParam2,
  D3D10DDI_HRESOURCE unnamedParam3,
  D3D10DDI_HRTRESOURCE unnamedParam4
)
{...}

Parametri

unnamedParam1

hDevice [in]

Handle per il dispositivo di visualizzazione (contesto grafico).

unnamedParam2

pCreateResource [in]

Puntatore a una struttura D3D11DDIARG_CREATERESOURCE che descrive i parametri usati dal driver di visualizzazione in modalità utente per creare una risorsa.

unnamedParam3

hResource [in]

Handle per i dati privati del driver per la risorsa.

unnamedParam4

hRTResource [in]

Handle per la risorsa che il driver userà quando viene chiamato nel runtime Direct3D.

Valore restituito

Nessuno

Osservazioni

Il driver può usare il pfnSetErrorCb funzione di callback per impostare un codice di errore.

Il driver potrebbe esaurire la memoria. Di conseguenza, il driver può passare E_OUTOFMEMORY o D3DDDIERR_DEVICEREMOVED in una chiamata alla funzione pfnSetErrorCb. Il driver può anche passare DXGI_DDI_ERR_UNSUPPORTED in una chiamata a pfnSetErrorCb. Per altre informazioni sul passaggio di DXGI_DDI_ERR_UNSUPPORTED, vedere la sezione Osservazioni della pagina di riferimento BltDXGI BltDXGI. Il runtime Direct3D determina che eventuali altri errori sono critici. Se il driver supera eventuali errori, inclusi D3DDDIERR_DEVICEREMOVED, il runtime Direct3D determina che l'handle non è valido; pertanto, il runtime non chiama la funzione DestroyResource(D3D10) per eliminare definitivamente l'handle specificato dal parametro hResource.

Il runtime convalida tutti i parametri rispetto ai parametri inviati da un'applicazione per creare la risorsa. Pertanto, il driver non deve ricevere combinazioni non valide.

Se l'applicazione non richiede la persistenza del contenuto della risorsa nelle presentazioni, il runtime imposta il flag D3D10_DDI_RESOURCE_MISC_DISCARD_ON_PRESENT dell'enumerazione D3D10_DDI_RESOURCE_MISC_FLAG nell'MiscFlags membro della struttura D3D11DDIARG_CREATERESOURCE a cui punta il parametro pCreateResource. La presentazione si verifica quando viene chiamato il PresentDXGI del driver o BltDXGI (con il flag present impostato nella struttura DXGI_DDI_ARG_BLT_FLAGS). Il runtime usa il flag D3D10_DDI_RESOURCE_MISC_DISCARD_ON_PRESENT per creare buffer back della catena di scambio quando un'applicazione usa il valore DXGI_SWAP_EFFECT_DISCARD per richiedere catene di scambio.

Creazione di un buffer nascosto stereo

A partire da Windows 8, se il driver deve creare un buffer nascosto stereo, deve impostare i membri della struttura D3D11DDIARG_CREATERESOURCE a cui punta pCreateResource come indicato di seguito:

Impostare il membro ArraySize su un valore pari a 2.
Impostare il valore del flag D3D10_DDI_BIND_PRESENT nel membro BindFlags.

Inoltre, per supportare la presentazione stereo, la funzione BltDXGI deve consentire qualsiasi valore per il DstSubresource e SrcSubresource membri della struttura DXGI_DDI_ARG_BLT che si trovano all'interno dell'intervallo delle risorse di origine e di destinazione.

Restrizioni sui valori di input

Per i driver Windows Display Driver Model (WDDM) 1.3 e versioni successive, il runtime di Microsoft Direct3D fornisce un set limitato di valori di input usati da questa funzione. Per un elenco di tutti i valori limitati, vedere [Miglioramenti delle prestazioni di rendering Direct3D](/windows-hardware/drivers/display/direct3d-rendering-performance-improvements).

Fabbisogno

Requisito	Valore
client minimo supportato	CreateResource(D3D11) è supportato a partire dal sistema operativo Windows 7.
piattaforma di destinazione	Desktop
intestazione	d3d10umddi.h (include D3d10umddi.h)