IMFDXGIDeviceManager::GetVideoService-Methode (mfobjects.h)

  • Artikel

Fragt das Microsoft Direct3D-Gerät nach einer Schnittstelle ab.

Syntax

HRESULT GetVideoService(
  [in]  HANDLE hDevice,
  [in]  REFIID riid,
  [out] void   **ppService
);

Parameter

[in] hDevice

Ein Handle für das Direct3D-Gerät. Rufen Sie zum Abrufen des Gerätehandles IMFDXGIDeviceManager::OpenDeviceHandle auf.

[in] riid

Der Schnittstellenbezeichner (Interface Identifier, IID) der angeforderten Schnittstelle. Das Direct3D-Gerät unterstützt die folgenden Schnittstellen:

  • ID3D11Geräte. Um einen Zeiger auf das Direct3D11-Gerät zu erhalten, verwenden Sie IID_ID3D11Device als Riid.
  • ID3D11VideoDevice. Um einen Zeiger auf das Direct3D11-Videogerät zu erhalten, verwenden Sie IID_ID3D11VideoDevice als Riid.

[out] ppService

Empfängt einen Zeiger auf die angeforderte Schnittstelle. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_HANDLE
 Das angegebene Handle ist kein Direct3D-Gerätehandle.
MF_E_DXGI_DEVICE_NOT_INITIALIZED
 Die DXGI-Geräte-Manager wurde nicht initialisiert. Der Besitzer des Geräts muss IMFDXGIDeviceManager::ResetDevice aufrufen.
MF_E_DXGI_NEW_VIDEO_DEVICE
 Das Gerätehandle ist ungültig.
E_NOINTERFACE
 Wenn ein ID3D11VideoDevice angegeben ist und das erstellte D3D-Gerät den Verweisraster oder WARP verwendet. Oder es handelt sich um ein Hardwaregerät, und Sie verwenden den Microsoft Basic Display Adapter.

Hinweise

Wenn die Methode MF_E_DXGI_NEW_VIDEO_DEVICE zurückgibt, rufen Sie IMFDXGIDeviceManager::CloseDeviceHandle auf, um das Handle zu schließen, und rufen Sie dann OpenDeviceHandle erneut auf, um ein neues Handle abzurufen. Mit der IMFDXGIDeviceManager::ResetDevice-Methode werden alle geöffneten Gerätehandles ungültig.

Weitere Informationen finden Sie unter Unterstützung der Direct3D 11-Videodecodierung in Media Foundation.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfobjects.h (include Mfidl.h)

Weitere Informationen

IMFDXGIDeviceManager