Condividi tramite


Metodo IDirect3DDeviceManager9::ResetDevice (dxva2api.h)

Imposta il dispositivo Direct3D o notifica alla gestione dispositivi che il dispositivo Direct3D è stato reimpostato.

Sintassi

HRESULT ResetDevice(
  [in] IDirect3DDevice9 *pDevice,
  [in] UINT             resetToken
);

Parametri

[in] pDevice

Puntatore all'interfaccia IDirect3DDevice9 del dispositivo Direct3D.

[in] resetToken

Token ricevuto nel parametro pResetToken della funzione DXVA2CreateDirect3DDeviceManager9 .

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito Descrizione
S_OK
Il metodo è riuscito.
E_INVALIDARG
Token non valido
D3DERR_INVALIDCALL
Errore del dispositivo Direct3D.

Commenti

Quando si crea per la prima volta la gestione dispositivi Direct3D, chiamare questo metodo con un puntatore al dispositivo Direct3D. Gestione dispositivi non crea il dispositivo; il chiamante deve fornire inizialmente il puntatore del dispositivo.

Chiamare anche questo metodo se il dispositivo Direct3D viene perso ed è necessario reimpostare il dispositivo o creare un nuovo dispositivo. Ciò si verifica se IDirect3DDevice9::TestCooperativeLevel restituisce D3DERR_DEVICELOST o D3DERR_DEVICENOTRESET. Per altre informazioni sui dispositivi persi, vedere la documentazione di Direct3D.

Il parametro resetToken garantisce che solo il componente che ha originariamente creato il gestore dispositivi possa invalidare il dispositivo corrente.

Se questo metodo ha esito positivo, tutti gli handle del dispositivo aperti diventano non validi.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione dxva2api.h

Vedi anche

Gestione dispositivi Direct3D

IDirect3DDeviceManager9