D3DDDI_ALLOCATIONINFO2 結構 (d3dukmdt.h)

發行項
02/26/2024

D3DDDI_ALLOCATIONINFO2 結構描述配置。

語法

typedef struct _D3DDDI_ALLOCATIONINFO2 {
  D3DKMT_HANDLE                         hAllocation;
  union {
    HANDLE     hSection;
    const VOID *pSystemMem;
  } D3DKMT_ALIGN64;
  void                                  D3DKMT_PTR(
    VOID               *unnamedParam1,
    pPrivateDriverData unnamedParam2
  );
  UINT                                  PrivateDriverDataSize;
  D3DDDI_VIDEO_PRESENT_SOURCE_ID        VidPnSourceId;
  union {
    struct {
      UINT Primary : 1;
      UINT Stereo : 1;
      UINT OverridePriority : 1;
#if ...
      UINT Reserved : 29;
#elif
      UINT Reserved : 30;
#else
      UINT Reserved : 31;
#endif
    };
    UINT Value;
  } Flags;
  D3DKMT_ALIGN64 D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
  union {
    UINT                     Priority;
    D3DKMT_ALIGN64 ULONG_PTR Unused;
  };
#if ...
  D3DKMT_ALIGN64 ULONG_PTR              Reserved[5];
#else
  D3DKMT_ALIGN64 ULONG_PTR              Reserved[6];
#endif
} D3DDDI_ALLOCATIONINFO2;

成員

hAllocation

[out] D3DKMT_HANDLE 句柄，表示配置的核心模式句柄。如果 Direct3D 執行時間的 pfnAllocateCb 函式在 D3DDDICB_ALLOCATE 結構的 hKMResource 成員中傳回非 NULL) ，此句 (柄會與核心模式資源句柄相關聯。使用者模式顯示驅動程式可以使用這個核心模式配置句柄來參考命令緩衝區中的配置。

D3DKMT_ALIGN64

與 hSection 和 pSystemMem 的聯集。

D3DKMT_ALIGN64.hSection

[in]有效區段物件的句柄。設定 D3DKMT_CREATEALLOCATIONFLAGS：：ExistingSection 時，請使用 hSection。

D3DKMT_ALIGN64.pSystemMem

[in]預先配置的系統記憶體指標。未設定 D3DKMT_CREATEALLOCATIONFLAGS：：ExistingSection 時，請使用 pSystemMem。

void D3DKMT_PTR( VOID *unnamedParam1, pPrivateDriverData unnamedParam2)

PrivateDriverDataSize

[in]以位元組為單位的私用數據大小。

VidPnSourceId

[in]視訊呈現網路路徑中視訊呈現來源的以零起始的 VidPN 識別碼，如果配置適用於主要介面， (VidPN) 拓撲。驅動程式應該只針對主要配置類型設定 VidPnSourceId ，而不是針對任何其他類型的配置設定。如果驅動程式在呼叫 pfnAllocateCb 函式時為任何其他配置類型設定 VidPnSourceId，pfnAllocateCb 會傳回D3DDDI_ID_NOTAPPLICABLE。

當 DirectX 圖形核心子系統起始共用主要介面的配置建立時，顯示迷你埠驅動程式可以從 DXGK_ALLOCATIONINFO D3DKMDDI_SHAREDPRIMARYSURFACEDATA結構的 pPrivateDriverData 成員指向的 D3DKMDDI_SHAREDPRIMARYSURFACEDATA 結構 VidPnSourceId 成員判斷標識符。

Flags

[in]包含結構或識別配置類型的32位值的等位。

Flags.Primary

[in]指定配置是否屬於桌面的 UINT。這類配置可隱含地供CPU存取。主要配置可以在建立時釘選，或無法在建立時釘選。

設定此成員相當於 (0x00000001) 設定 32 位 Value 成員的第一個位。

Flags.Stereo

[in]從 Windows 8 (WDDM 1.2) 開始支援。 UINT，指定配置是否為立體主要配置。只有在設定主要成員時，才能設定立體成員。

設定此成員相當於 (0x00000002) 設定 32 位 Value 成員的第二個位。

Flags.OverridePriority

[in]從 Windows 10 1703 版 (WDDM 2.2) 開始支援。覆寫優先順序，如使用者模式圖形驅動程式所建立。

Flags.Reserved

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

Flags.Value

[in]識別配置類型的32位值。

GpuVirtualAddress

[out]所建立配置的 GPU 虛擬位址。

Priority

[in]配置的優先順序。

Unused

未使用的。

Reserved[5]

Reserved[6]

備註

當使用者模式顯示驅動程式在 D3DDDI_ALLOCATIONINFO的 Flags 成員中設定主要位字段旗標時，某些限制會套用至DXGKARG_CREATEALLOCATION結構之 pAllocationInfo 成員中的DXGK_ALLOCATIONINFO結構，以便呼叫 display miniport 驅動程式的 DxgkDdiCreateAllocation 函式。這些限制包括下列各項：