D3DDDI_ALLOCATIONINFO Struktur (d3dukmdt.h)

Die D3DDDI_ALLOCATIONINFO Struktur beschreibt eine Zuordnung.

Syntax

typedef struct _D3DDDI_ALLOCATIONINFO {
  [out]    D3DKMT_HANDLE                  hAllocation;
  void                           D3DKMT_PTR(
    const VOID *unnamedParam1,
    pSystemMem unnamedParam2
  );
  void                           D3DKMT_PTR(
    VOID               *unnamedParam1,
    pPrivateDriverData unnamedParam2
  );
  [in]     UINT                           PrivateDriverDataSize;
  [in]     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;

Member

[out] hAllocation

Ein D3DKMT_HANDLE Datentyp, der einen Kernelmodus-Handle für die Zuordnung darstellt. Dieser Kernelmodus-Zuordnungshandpunkt ist dem Kernelmodus-Ressourcenhandpunkt (wenn nicht NULL) zugeordnet, dass die PfnAllocateCb-Funktion der Microsoft Direct3D-Runtime im hKMResource-Element der D3DDDICB_ALLOCATE-Struktur zurückgegeben wird. Der Benutzermodus-Anzeigetreiber kann diesen Kernelmodus-Zuordnungshandpunkt verwenden, um auf die Zuordnung im Befehlspuffer zu verweisen.

void D3DKMT_PTR( const VOID *unnamedParam1, pSystemMem unnamedParam2)

void D3DKMT_PTR( VOID *unnamedParam1, pPrivateDriverData unnamedParam2)

[in] PrivateDriverDataSize

Die Größe in Bytes des Blocks privater Daten, auf den pPrivateDriverData verweist.

[in] VidPnSourceId

Die Null-basierte Identifikationsnummer der video vorhandenen Quelle in einem Pfad eines video präsentierenden Netzwerks (VidPN)-Topologie, wenn die Zuordnung für die primäre Oberfläche ist. Der Treiber sollte VidPnSourceId nur für primäre Zuordnungstypen und nicht für einen anderen Zuordnungstyp festlegen. Wenn der Treiber VidPnSourceId für einen anderen Zuordnungstyp in einem Aufruf der PfnAllocateCb-Funktion festlegt, gibt pfnAllocateCb D3DDDI_ID_NOTAPPLICABLE zurück.

Wenn das DirectX-Grafik-Kernel-Subsystem die Erstellung der Zuordnung für die freigegebene primäre Oberfläche initiiert, kann der Anzeige-Miniporttreiber die Identifikationsnummer aus dem VidPnSourceId-Element der D3DKMDDI_SHAREDPRIMARYSURFACEDATA Struktur bestimmen, auf die das pPrivateDriverData-Element der DXGK_ALLOCATIONINFO-Struktur verweist.

[in] Flags

Eine Union, die entweder eine Struktur (mit den ersten drei Mitgliedern enthält, die in der folgenden Liste beschrieben werden) oder einen 32-Bit-Wert (im Wertelement ), der den Typ der Zuordnung eindrückt:

[in] Flags.Primary

Ein UINT, der angibt, ob die Zuordnung Teil des Desktops ist. Eine solche Zuordnung ist implizit für die CPU zugänglich. Eine primäre Zuordnung kann entweder bei der Erstellung angeheftet oder nicht bei der Erstellung angeheftet werden.

Das Festlegen dieses Elements entspricht dem Festlegen des ersten Bits des 32-Bit-Wertmitglieds (0x00000001).

[in] Flags.Stereo

Unterstützt ab Windows 8.

Ein UINT, der angibt, ob die Zuordnung eine Stereo-Primärzuweisung ist. Das Stereo-Element kann nur festgelegt werden, wenn das Primäre Element festgelegt ist.

Das Festlegen dieses Elements entspricht dem Festlegen des zweiten Bits des 32-Bit-Wertelements (0x00000002).

[in] Flags.Reserved

Unterstützt ab Windows 8.

Dieses Element ist reserviert und sollte auf Null festgelegt werden.

Das Festlegen dieses Members auf Null entspricht dem Festlegen der verbleibenden 30 Bit (0xFFFFFFFC) des 32-Bit-Wert-Members auf Nullen.

[in] Dieses Element ist reserviert und sollte auf Null festgelegt werden.

Das Festlegen dieses Members auf Null entspricht dem Festlegen der verbleibenden 31 Bit (0xFFFFFFFE) des 32-Bit-Wert-Members auf Nullen.

[in] Flags.Value

Ein 32-Bit-Wert, der den Typ der Zuordnung identifiziert.

Bemerkungen

Wenn der Benutzermodus-Anzeigetreiber das Primäre Bitfeld-Feld-Flag im Element " Flags " D3DDDI_ALLOCATIONINFO festlegt, gelten bestimmte Einschränkungen für die DXGK_ALLOCATIONINFO-Struktur im pAllocationInfo-Element der DXGKARG_CREATEALLOCATION-Struktur für die Zuordnung in einem Aufruf zur Anzeige der DxgkDdiCreateAllocation-Funktion des Display-Miniporttreibers. Es gelten folgende Einschränkungen:

  • Die Zuweisung wird entsprechend den Einstellungen zugewiesen; andernfalls muss die Zuordnung standardmäßig auf den unterstützten Schreibsegmentsatz festgelegt werden, und alle angegebenen Segmente im Schreibsegmentsatz müssen CPU-barrierefrei sein.
  • Der Anzeige-Miniporttreiber kann die folgenden Bitfeld-Flags im Element " Flags " von DXGK_ALLOCATIONINFO nicht festlegen:
    • PermanentSysMem
    • Zwischengespeichert
    • Protected
    • ExistingSysMem
    • ExistingKernelSysMem
Die D3DDDI_ID_NOTAPPLICABLE Konstante wird in D3dukmdt.h definiert.

Anforderungen

   
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und späteren Versionen der Windows-Betriebssysteme.
Header d3dukmdt.h (einschließlich D3dumddi.h, D3dkmddi.h)

Weitere Informationen

CreateResource

D3DDDICB_ALLOCATE

D3DDDI_SURFACEINFO

D3DKMDDI_SHAREDPRIMARYSURFACEDATA

DXGKARG_CREATEALLOCATION

DXGK_ALLOCATIONINFO

DxgkDdiCreateAllocation

pfnAllocateCb