D3DKMT_OPENRESOURCEFROMNTHANDLE Struktur (d3dkmthk.h)

  • Artikel

Beschreibt Informationen, die erforderlich sind, um eine freigegebene Ressource von einem NT-Handle für den Prozess zu öffnen. Die freigegebene Ressource kann eine Reihe von Zuordnungen, ein Schlüsselmutex oder ein Synchronisierungsobjekt sein.

Syntax

typedef struct _D3DKMT_OPENRESOURCEFROMNTHANDLE {
  [in]  D3DKMT_HANDLE              hDevice;
  [in]  HANDLE                     hNtHandle;
  [in]  UINT                       NumAllocations;
  [in]  D3DDDI_OPENALLOCATIONINFO2 *pOpenAllocationInfo2;
  [in]  UINT                       PrivateRuntimeDataSize;
  [in]  VOID                       *pPrivateRuntimeData;
  [in]  UINT                       ResourcePrivateDriverDataSize;
  [in]  VOID                       *pResourcePrivateDriverData;
  [in]  UINT                       TotalPrivateDriverDataBufferSize;
  [in]  VOID                       *pTotalPrivateDriverDataBuffer;
  [out] D3DKMT_HANDLE              hResource;
  [out] D3DKMT_HANDLE              hKeyedMutex;
  [in]  VOID                       *pKeyedMutexPrivateRuntimeData;
  [in]  UINT                       KeyedMutexPrivateRuntimeDataSize;
  [out] D3DKMT_HANDLE              hSyncObject;
} D3DKMT_OPENRESOURCEFROMNTHANDLE;

Member

[in] hDevice

Ein D3DKMT_HANDLE Datentyp, der das Gerät darstellt.

[in] hNtHandle

Ein NT-Handle für den Prozess.

[in] NumAllocations

Die Anzahl der Zuordnungen, die der Ressource zugeordnet sind.

[in] pOpenAllocationInfo2

Dieser Member ist reserviert und sollte auf 0 (null) festgelegt werden.

[in] PrivateRuntimeDataSize

Die Größe des Puffers in Bytes, auf den das pPrivateRuntimeData-Element verweist.

[in] pPrivateRuntimeData

Ein vom Aufrufer bereitgestellter Puffer, in den die dieser Ressource zugeordneten privaten Laufzeitdaten kopiert werden.

[in] ResourcePrivateDriverDataSize

Die Größe des Puffers in Bytes, auf den das pResourcePrivateDriverData-Element verweist.

[in] pResourcePrivateDriverData

Ein vom Aufrufer bereitgestellter Puffer, in den die der Ressource zugeordneten privaten Treiberdaten kopiert werden.

[in] TotalPrivateDriverDataBufferSize

Die Größe des Puffers in Bytes, auf den der pTotalPrivateDriverDataBuffer-Member verweist.

[out] Die Größe der in pTotalPrivateDriverDataBuffer geschriebenen Daten in Bytes.

[in] pTotalPrivateDriverDataBuffer

Ein Zeiger auf einen vom Aufrufer bereitgestellten Puffer, in dem die privaten Treiberdaten gespeichert werden.

[out] hResource

Ein Handle für die Ressource in diesem Prozess.

[out] hKeyedMutex

Ein Handle für den schlüsselierten Mutex in diesem Prozess.

[in] pKeyedMutexPrivateRuntimeData

Ein Puffer, der anfängliche private Daten enthält.

Die Daten in diesem Puffer werden nur kopiert, wenn der schlüsselierte Mutex nicht bereits über private Daten verfügt.

Wenn dieser Member den Wert NULL aufweist, muss der Wert des KeyedMutexPrivateRuntimeDataSize-Elements null sein.

[in] KeyedMutexPrivateRuntimeDataSize

Die Größe des Puffers in Bytes, auf den das pKeyedMutexPrivateRuntimeData-Element verweist.

[out] hSyncObject

Ein Handle für das Synchronisierungsobjekt in diesem Prozess.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Kopfzeile d3dkmthk.h (include D3dkmthk.h)

Weitere Informationen

D3DDDI_OPENALLOCATIONINFO2

D3DKMTOpenNtHandleFromName

D3DKMTShareObjects