structure D3DKMT_OPENRESOURCEFROMNTHANDLE (d3dkmthk.h)

  • Article

Décrit les informations requises pour ouvrir une ressource partagée à partir d’un handle NT vers le processus. La ressource partagée peut être un ensemble d’allocations, un mutex à clé ou un objet de synchronisation.

Syntaxe

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;

Membres

[in] hDevice

Un D3DKMT_HANDLE type de données qui représente l’appareil.

[in] hNtHandle

Un handle NT pour le processus.

[in] NumAllocations

Nombre d’allocations associées à la ressource.

[in] pOpenAllocationInfo2

Ce membre est réservé et doit être défini sur zéro.

[in] PrivateRuntimeDataSize

Taille, en octets, de la mémoire tampon pointée par le membre pPrivateRuntimeData .

[in] pPrivateRuntimeData

Mémoire tampon fournie par l’appelant dans laquelle les données privées du runtime associées à cette ressource seront copiées.

[in] ResourcePrivateDriverDataSize

Taille, en octets, de la mémoire tampon pointée vers le membre pResourcePrivateDriverData .

[in] pResourcePrivateDriverData

Mémoire tampon fournie par l’appelant dans laquelle les données privées du pilote associées à la ressource seront copiées.

[in] TotalPrivateDriverDataBufferSize

Taille, en octets, de la mémoire tampon vers laquelle pointe le membre pTotalPrivateDriverDataBuffer .

[out] Taille, en octets, des données écrites dans pTotalPrivateDriverDataBuffer.

[in] pTotalPrivateDriverDataBuffer

Pointeur vers une mémoire tampon fournie par l’appelant où les données privées du pilote seront stockées.

[out] hResource

Handle de la ressource dans ce processus.

[out] hKeyedMutex

Handle du mutex à clé dans ce processus.

[in] pKeyedMutexPrivateRuntimeData

Mémoire tampon qui contient des données privées initiales.

Les données de cette mémoire tampon ne seront copiées que si le mutex à clé n’a pas déjà de données privées.

Si ce membre a la valeur NULL, la valeur du membre KeyedMutexPrivateRuntimeDataSize doit être égale à zéro.

[in] KeyedMutexPrivateRuntimeDataSize

Taille, en octets, de la mémoire tampon pointée par le membre pKeyedMutexPrivateRuntimeData .

[out] hSyncObject

Handle de l’objet de synchronisation dans ce processus.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8
Serveur minimal pris en charge Windows Server 2012
En-tête d3dkmthk.h (inclure D3dkmthk.h)

Voir aussi

D3DDDI_OPENALLOCATIONINFO2

D3DKMTOpenNtHandleFromName

D3DKMTShareObjects