IDXGIFactory2::GetSharedResourceAdapterLuid-Methode (dxgi1_2.h)

Artikel
03/01/2024

Gibt den Adapter an, auf dem ein freigegebenes Ressourcenobjekt erstellt wurde.

Syntax

HRESULT GetSharedResourceAdapterLuid(
  [in]  HANDLE hResource,
  [out] LUID   *pLuid
);

Parameter

[in] hResource

Ein Handle für ein freigegebenes Ressourcenobjekt. Die IDXGIResource1::CreateSharedHandle-Methode gibt dieses Handle zurück.

[out] pLuid

Ein Zeiger auf eine Variable, die einen LUID-Wert (Lokal eindeutiger Bezeichner) empfängt, der den Adapter identifiziert. LUID ist in Dxgi.h definiert. Eine LUID ist ein 64-Bit-Wert, der garantiert nur für das Betriebssystem, unter dem er generiert wurde, eindeutig ist. Die Eindeutigkeit einer LUID ist nur garantiert, bis das Betriebssystem neu gestartet wird.

Rückgabewert

GetSharedResourceAdapterLuid gibt Folgendes zurück:

S_OK, wenn der Adapter identifiziert wurde.
DXGI_ERROR_INVALID_CALL , wenn hResource ungültig ist.
Möglicherweise andere Fehlercodes, die im Thema DXGI_ERROR beschrieben werden.

Plattformupdate für Windows 7: Unter Windows 7 oder Windows Server 2008 R2 mit installiertem Plattformupdate für Windows 7 schlägt GetSharedResourceAdapterLuid mit E_NOTIMPL fehl. Weitere Informationen zum Plattformupdate für Windows 7 finden Sie unter Plattformupdate für Windows 7.

Hinweise

Sie können Ressourcen nicht adapterübergreifend freigeben. Daher können Sie keine freigegebene Ressource auf einem anderen Adapter als dem Adapter öffnen, auf dem die Ressource erstellt wurde. Rufen Sie GetSharedResourceAdapterLuid auf, bevor Sie eine freigegebene Ressource öffnen, um sicherzustellen, dass die Ressource auf dem entsprechenden Adapter erstellt wurde. Um eine freigegebene Ressource zu öffnen, rufen Sie die ID3D11Device1::OpenSharedResource1 - oder ID3D11Device1::OpenSharedResourceByName-Methode auf.

Beispiele

HANDLE handle;
IDXGIFactory2* pFactory;

LUID luid;
pFactory->GetSharedResourceAdapterLuid (handle, &luid);

UINT index = 0;
IDXGIAdapter* pAdapter = NULL;
while (SUCCEEDED(pFactory->EnumAdapters(index, &pAdapter)))
{
    DXGI_ADAPTER_DESC desc;
    pAdapter->GetDesc(&desc);
    if (desc.AdapterLuid == luid)
    {
       // Identified a matching adapter.
       break;
    }
    pAdapter->Release();
    pAdapter = NULL;
    index++;
}
// At this point, if pAdapter is non-null, you identified an adapter that 
// can open the shared resource.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	dxgi1_2.h
Bibliothek	Dxgi.lib

Weitere Informationen

IDXGIFactory2

Freigeben über