структура D3DKMT_OPENRESOURCEFROMNTHANDLE (d3dkmthk.h)

  • Статья

Описывает сведения, необходимые для открытия общего ресурса из дескриптора NT в процесс. Общий ресурс может быть набором выделений, мьютексом с ключом или объектом синхронизации.

Синтаксис

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;

Члены

[in] hDevice

Тип данных D3DKMT_HANDLE, представляющий устройство.

[in] hNtHandle

Дескриптор NT для процесса.

[in] NumAllocations

Количество выделений, связанных с ресурсом.

[in] pOpenAllocationInfo2

Этот элемент зарезервирован и должен иметь нулевое значение.

[in] PrivateRuntimeDataSize

Размер (в байтах) буфера, на который указывает элемент pPrivateRuntimeData .

[in] pPrivateRuntimeData

Буфер, предоставленный вызывающим объектом, в который будут скопированы частные данные среды выполнения, связанные с этим ресурсом.

[in] ResourcePrivateDriverDataSize

Размер (в байтах) буфера, на который указывает элемент pResourcePrivateDriverData .

[in] pResourcePrivateDriverData

Буфер, предоставленный вызывающим объектом, в который будут скопированы личные данные драйвера, связанные с ресурсом.

[in] TotalPrivateDriverDataBufferSize

Размер (в байтах) буфера, на который указывает элемент pTotalPrivateDriverDataBuffer .

[out] Размер в байтах данных, записанных в pTotalPrivateDriverDataBuffer.

[in] pTotalPrivateDriverDataBuffer

Указатель на буфер, предоставленный вызывающим объектом, в котором будут храниться личные данные драйвера.

[out] hResource

Дескриптор ресурса в этом процессе.

[out] hKeyedMutex

Дескриптор мьютекса с ключом в этом процессе.

[in] pKeyedMutexPrivateRuntimeData

Буфер, содержащий начальные частные данные.

Данные в этом буфере будут скопированы только в том случае, если у мьютекса с ключом еще нет закрытых данных.

Если этот элемент имеет значение NULL, значение элемента KeyedMutexPrivateRuntimeDataSize должно быть равно нулю.

[in] KeyedMutexPrivateRuntimeDataSize

Размер (в байтах) буфера, на который указывает элемент pKeyedMutexPrivateRuntimeData .

[out] hSyncObject

Дескриптор объекта синхронизации в этом процессе.

Требования

Требование Значение
Минимальная версия клиента Windows 8
Минимальная версия сервера Windows Server 2012
Верхняя часть d3dkmthk.h (включая D3dkmthk.h)

См. также раздел

D3DDDI_OPENALLOCATIONINFO2

D3DKMTOpenNtHandleFromName

D3DKMTShareObjects