D3DDDIARG_OPENRESOURCE 結構 (d3dumddi.h)

  • 發行項

D3DDDIARG_OPENRESOURCE結構包含開啟共用資源的資訊。

語法

typedef struct _D3DDDIARG_OPENRESOURCE {
  [in]     UINT                      NumAllocations;
  union {
    [in]     D3DDDI_OPENALLOCATIONINFO  *pOpenAllocationInfo;
             D3DDDI_OPENALLOCATIONINFO2 *pOpenAllocationInfo2;
  };
  [in]     D3DDDI_OPENALLOCATIONINFO *pOpenAllocationInfo;
  [in]     D3DKMT_HANDLE             hKMResource;
  [in]     VOID                      *pPrivateDriverData;
  [in]     UINT                      PrivateDriverDataSize;
  [in/out] HANDLE                    hResource;
  [in]     D3DDDI_ROTATION           Rotation;
  [in]     D3DDDI_OPENRESOURCEFLAGS  Flags;
} D3DDDIARG_OPENRESOURCE;

成員

[in] NumAllocations

pOpenAllocationInfo 所指定陣列中的元素數目。 NumAllocations 代表要開啟的配置數目。

[in] pOpenAllocationInfo

描述要開啟之資源中配置 之D3DDDI_OPENALLOCATIONINFO 結構的陣列。

[in]描述要開啟之資源中配置 之D3DDDI_OPENALLOCATIONINFO 結構的陣列。

pOpenAllocationInfo2

這個成員是保留的，而且應該設定為零。

此成員從 Windows 7 開始可供使用。

[in] hKMResource

D3DKMT_HANDLE數據類型，表示與配置相關聯之資源的核心模式句柄。

這個核心模式句柄代表先前透過呼叫使用者模式顯示驅動程式 CreateResource 函式所建立的現有共享資源。

[in] pPrivateDriverData

建立資源時傳遞給顯示迷你埠驅動程式之私用數據的指標。 此數據是每個資源，而不是每個配置，例如每個配置 D3DDDI_OPENALLOCATIONINFO 結構中的私用數據。

[in] PrivateDriverDataSize

pPrivateDriverData 所指向之私用數據的大小，以位元組為單位。

[in/out] hResource

與配置相關聯的資源句柄。

使用者模式顯示驅動程式應該儲存此句柄，並使用它來識別驅動程式回呼至 Microsoft Direct3D 運行時間的資源。 使用者模式顯示驅動程式應該會產生唯一的句柄，並將它傳回 Direct3D 運行時間。 Direct3D 運行時間會在驅動程式呼叫中使用這個句柄來識別資源。

[in] Rotation

識別共用主要資源方向 的D3DDDI_ROTATION型別值。

當主要資源與全螢幕裝置搭配使用且旋轉時，可能需要驅動程式建立過渡配置來處理全螢幕裝置。 [全螢幕位欄位] 旗標是在 Flags 成員中設定，以指出主要資源與全螢幕裝置搭配使用。

[in] Flags

識別要開啟之資源類型的 D3DDDI_OPENRESOURCEFLAGS 結構。

備註

主要和 SharedResource 位字段旗標是在呼叫 CreateResource 函式以建立共用主要資源的 flags 成員中設定的 D3DDDIARG_CREATERESOURCE 結構。

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
標頭 d3dumddi.h (包含 D3dumddi.h)

另請參閱

CreateResource

D3DDDIARG_CREATERESOURCE

D3DDDI_OPENALLOCATIONINFO

D3DDDI_OPENRESOURCEFLAGS

D3DDDI_ROTATION

OpenResource