PFND3D10DDI_SO_SETTARGETS funzione di callback (d3d10umddi.h)

  • Articolo

La funzione SoSetTargets imposta le risorse di destinazione dell'output del flusso.

Sintassi

PFND3D10DDI_SO_SETTARGETS Pfnd3d10ddiSoSettargets;

void Pfnd3d10ddiSoSettargets(
       D3D10DDI_HDEVICE unnamedParam1,
  [in] UINT NumBuffers,
  [in] UINT ClearTargets,
       const D3D10DDI_HRESOURCE *unnamedParam4,
       const UINT *unnamedParam5
)
{...}

Parametri

unnamedParam1

hDevice [in]

Handle per il dispositivo di visualizzazione (contesto grafico).

[in] NumBuffers

Numero di elementi nella matrice specificata da phResource .

[in] ClearTargets

Numero di handle per trasmettere le risorse di destinazione di output che rappresenta la differenza tra il numero precedente di risorse di destinazione di output del flusso (prima che il runtime Di Microsoft Direct3D chiami SoSetTargets) e il nuovo numero di risorse di destinazione dell'output di flusso.

Si noti che il numero specificato dai ClearTargets è solo un aiuto di ottimizzazione perché il driver di visualizzazione in modalità utente potrebbe calcolare questo numero.

unnamedParam4

phResource [in]

Matrice di handle per le risorse di destinazione dell'output del flusso da impostare. Si noti che alcuni valori handle possono essere NULL.

unnamedParam5

pOffsets [in]

Matrice di offset, in byte, nelle risorse di destinazione dell'output del flusso nella matrice specificata da phResource .

Valore restituito

nessuno

Osservazioni

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

Intervallo di risorse di destinazione dell'output di flusso tra il numero specificato dal parametro SOTargets e il numero massimo di risorse di destinazione di output di flusso consentite deve contenere tutti i valori NULL o non associati. Il numero specificato dal parametro ClearTargets indica al driver il numero di punti di associazione che il driver deve cancellare per l'operazione corrente. Se la chiamata precedente a SoSetTargets ha passato un valore pari a 2 in SOTargetse la chiamata corrente a SoSetTargets passa un valore pari a 4 in SOTargets, la chiamata corrente a SoSetTargets passa anche il valore 0 nel parametro ClearTargets . Se la chiamata successiva a SoSetTargets passa un valore pari a 1 in SOTargets, la chiamata successiva passa anche un valore pari a 3 (4 - 1) in ClearTargets.

Il driver non deve riscontrare errori, ad eccezione di D3DDDIERR_DEVICEREMOVED. Pertanto, se il driver passa qualsiasi errore, ad eccezione di D3DDDIERR_DEVICEREMOVED, in una chiamata alla funzione pfnSetErrorCb , il runtime di Microsoft Direct3D determinerà che l'errore è critico. Anche se il dispositivo è stato rimosso, il driver non deve restituire D3DDDIERR_DEVICEREMOVED; Tuttavia, se la rimozione del dispositivo interferisce con l'operazione di SOTargets (che in genere non dovrebbe verificarsi), il driver può restituire D3DDDIERR_DEVICEREMOVED.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione Desktop
Intestazione d3d10umddi.h (include D3d10umddi.h)

Vedi anche

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb