D3DDDI_ALLOCATIONINFO 結構 (d3dukmdt.h)

發行項
02/23/2024

D3DDDI_ALLOCATIONINFO結構描述 WDDM v1 的配置。使用者模式圖形客戶端應該改用 D3DDDI_ALLOCATIONINFO2 。

語法

typedef struct _D3DDDI_ALLOCATIONINFO {
  D3DKMT_HANDLE                  hAllocation;
  void                           D3DKMT_PTR(
    const VOID *unnamedParam1,
    pSystemMem unnamedParam2
  );
  void                           D3DKMT_PTR(
    VOID               *unnamedParam1,
    pPrivateDriverData unnamedParam2
  );
  UINT                           PrivateDriverDataSize;
  D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  union {
    struct {
      UINT Primary : 1;
      UINT Stereo : 1;
#if ...
      UINT Reserved : 30;
#else
      UINT Reserved : 31;
#endif
    };
    UINT Value;
  } Flags;
} D3DDDI_ALLOCATIONINFO;

成員

hAllocation

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

void D3DKMT_PTR( const VOID *unnamedParam1, pSystemMem unnamedParam2)

void D3DKMT_PTR( VOID *unnamedParam1, pPrivateDriverData unnamedParam2)

PrivateDriverDataSize

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

VidPnSourceId

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

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

Flags

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

Flags.Primary

[in]UINT，指定配置是否為桌面的一部分。這類配置可供 CPU 隱含存取。主要配置可以在建立時釘選或未釘選在建立時釘選。

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

Flags.Stereo

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

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

Flags.Reserved

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

Flags.Value

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

備註

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