Metodo IMFDXGIDeviceManager::ResetDevice (mfobjects.h)

Articolo
03/13/2024

Imposta il dispositivo Microsoft Direct3D o notifica al gestore dispositivi che il dispositivo Direct3D è stato reimpostato.

Sintassi

HRESULT ResetDevice(
  [in] IUnknown *pUnkDevice,
  [in] UINT     resetToken
);

Parametri

[in] pUnkDevice

Puntatore all'interfaccia IUnknown del dispositivo DXGI.

[in] resetToken

Token ricevuto nel parametro pResetToken della funzione MFCreateDXGIDeviceManager .

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Quando si crea per la prima volta il Gestione dispositivi DXGI, chiamare questo metodo con un puntatore al dispositivo Direct3D. Il gestore 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.

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.

Per creare un dispositivo Microsoft Direct3D 11, chiama D3D11CreateDevice.

Il dispositivo deve essere creato con il flag di creazione del dispositivo D3D11_CREATE_DEVICE_VIDEO_SUPPORT definito nell'enumerazione D3D11_CREATE_DEVICE_FLAG .

È consigliabile usare la protezione multithread nel contesto del dispositivo per evitare problemi di deadlock che talvolta possono verificarsi quando si chiama ID3D11VideoContext::GetDecoderBuffer o ID3D11VideoContext::ReleaseDecoderBuffer. Per impostare la protezione multithread, chiamare prima QueryInterface su ID3D11Device per ottenere un puntatore ID3D10Multithread . Chiama quindi ID3D10Multithread::SetMultithreadProtected, passando true per bMTProtect.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	mfobjects.h (include Mfidl.h)

Vedi anche

IMFDXGIDeviceManager

Condividi tramite