IDirect3DDevice Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Il représente un IDXGIDevice et peut être utilisé pour interagir entre Windows Runtime composants qui doivent échanger des références IDXGIDevice.
public interface class IDirect3DDevice : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(2742428843, 36191, 18000, 157, 62, 158, 174, 61, 155, 198, 112)]
struct IDirect3DDevice : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(2742428843, 36191, 18000, 157, 62, 158, 174, 61, 155, 198, 112)]
public interface IDirect3DDevice : System.IDisposable
Public Interface IDirect3DDevice
Implements IDisposable
- Attributs
- Implémente
Configuration requise pour Windows
Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Exemples
// Create a new Windows Console Application (C++/WinRT) project, and
// replace the contents of `pch.h` and `main.cpp` source code files with the code below.
// Be aware that the code below omits the details of obtaining a WinRT Direct3DDevice in
// the first segment of code, and obtaining a native DirectX device in the second segment.
// The code shows only how to perform the conversion between the two.
// pch.h
#pragma once
#include <d3d11_4.h>
#include <Windows.Graphics.DirectX.Direct3D11.interop.h>
#include <unknwn.h>
#include <winrt/Windows.Foundation.h>
#include <winrt/Windows.Foundation.Collections.h>
#include <winrt/Windows.Graphics.DirectX.Direct3D11.h>
// main.cpp
#include "pch.h"
int main()
{
winrt::init_apartment();
// To get the native DirectX device that is wrapped by a Direct3DDevice.
winrt::Windows::Graphics::DirectX::Direct3D11::IDirect3DDevice d3dDevice /* = ... */;
winrt::com_ptr<::Windows::Graphics::DirectX::Direct3D11::IDirect3DDxgiInterfaceAccess> dxgiInterfaceAccess{
d3dDevice.as<::Windows::Graphics::DirectX::Direct3D11::IDirect3DDxgiInterfaceAccess>()
};
winrt::com_ptr<::IDXGIDevice> nativeDevice;
winrt::check_hresult(dxgiInterfaceAccess->GetInterface(
__uuidof(nativeDevice),
nativeDevice.put_void()));
// To create a new Direct3DDevice object wrapping a native DirectX device.
winrt::com_ptr<::IDXGIDevice> nativeDevice2 /* = ... */;
winrt::Windows::Graphics::DirectX::Direct3D11::IDirect3DDevice d3dDevice2{ nullptr };
winrt::check_hresult(::CreateDirect3D11DeviceFromDXGIDevice(
nativeDevice2.get(),
reinterpret_cast<::IInspectable**>(winrt::put_abi(d3dDevice2))));
}
// First include the necessary headers and namespaces.
#include <Windows.Graphics.DirectX.Direct3D11.interop.h>
#include <dxgi.h>
using namespace Windows::Graphics::DirectX::Direct3D11;
using namespace Microsoft::WRL;
// To get the native DirectX device that is wrapped by a Direct3DDevice.
IDirect3DDevice^ d3dDevice = ...;
ComPtr<IDXGIDevice> nativeDevice;
HRESULT hr = GetDXGIInterface(d3dDevice, nativeDevice.GetAddressOf());
// To create a new Direct3DDevice object wrapping a native DirectX device.
ComPtr<IDXGIDevice> nativeDevice = ...;
IDirect3DDevice^ winRTDevice = CreateDirect3DDevice(nativeDevice.Get());
Remarques
Si vous utilisez C++/WinRT, puis pour vous déplacer entre IDirect3DDevice et IDXGIDevice, utilisez les fonctions IDirect3DxgiInterfaceAccess::GetInterface et CreateDirect3D11DeviceFromDXGIDevice . Vous pouvez voir un autre exemple de code dans l’interopérabilité native de composition avec DirectX et Direct2D.
Si vous utilisez C++/CX, utilisez les fonctions CreateDirect3DDevice et GetDXGIInterface(IDirect3DDevice^, DXGI_TYPE**).
Méthodes
Dispose() |
Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. |
Trim() |
Réduit la mémoire graphique allouée par le périphérique graphique pour le compte de l’application. |