D3DKMT_OPENRESOURCEFROMNTHANDLE structure (d3dkmthk.h)

Describes information that is required to open a shared resource from an NT handle to the process. The shared resource can be a set of allocations, a keyed mutex, or a synchronization object.

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;

Members

[in] hDevice

A D3DKMT_HANDLE data type that represents the device.

[in] hNtHandle

An NT handle to the process.

[in] NumAllocations

The number of allocations associated with the resource.

[in] pOpenAllocationInfo2

This member is reserved and should be set to zero.

[in] PrivateRuntimeDataSize

The size, in bytes, of the buffer pointed to by the pPrivateRuntimeData member.

[in] pPrivateRuntimeData

A caller-supplied buffer where the runtime private data associated with this resource will be copied to.

[in] ResourcePrivateDriverDataSize

The size, in bytes, of the buffer pointed to by the pResourcePrivateDriverData member.

[in] pResourcePrivateDriverData

A caller-supplied buffer where the driver private data associated with the resource will be copied to.

[in] TotalPrivateDriverDataBufferSize

The size, in bytes, of the buffer pointed to by the pTotalPrivateDriverDataBuffer member.

[out] The size, in bytes, of the data written to pTotalPrivateDriverDataBuffer.

[in] pTotalPrivateDriverDataBuffer

A pointer to a caller-supplied buffer where the driver private data will be stored.

[out] hResource

A handle to the resource in this process.

[out] hKeyedMutex

A handle to the keyed mutex in this process.

[in] pKeyedMutexPrivateRuntimeData

A buffer that contains initial private data.

The data in this buffer will be copied only if the keyed mutex does not already have private data.

If this member has a value of NULL, the value of the KeyedMutexPrivateRuntimeDataSize member must be zero.

[in] KeyedMutexPrivateRuntimeDataSize

The size, in bytes, of the buffer pointed to by the pKeyedMutexPrivateRuntimeData member.

[out] hSyncObject

A handle to the synchronization object in this process.

Requirements

See also

D3DDDI_OPENALLOCATIONINFO2

D3DKMTOpenNtHandleFromName

D3DKMTShareObjects