D3DDDIARG_OPENRESOURCE-Struktur (d3dumddi.h)

Die D3DDDIARG_OPENRESOURCE-Struktur enthält Informationen zum Öffnen einer freigegebenen Ressource.

Syntax

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;

Member

[in] NumAllocations

Die Anzahl der Elemente im Array, die von pOpenAllocationInfo angegeben wird. NumAllocations stellt die Anzahl der zu öffnenden Zuordnungen dar.

[in] pOpenAllocationInfo

Ein Array von D3DDDI_OPENALLOCATIONINFO Strukturen, die die Zuordnungen in der zu öffnenden Ressource beschreiben.

[in] Ein Array von D3DDDI_OPENALLOCATIONINFO Strukturen, die die Zuordnungen in der zu öffnenden Ressource beschreiben.

pOpenAllocationInfo2

Dieser Member ist reserviert und sollte auf 0 (null) festgelegt werden.

Dieses Mitglied ist ab Windows 7 verfügbar.

[in] hKMResource

Ein D3DKMT_HANDLE Datentyp, der ein Kernelmodushandle für die Ressource darstellt, die den Zuordnungen zugeordnet ist.

Dieses Kernelmodushandle stellt eine vorhandene freigegebene Ressource dar, die zuvor durch einen Aufruf der CreateResource-Funktion des Benutzermodusanzeigetreibers erstellt wurde.

[in] pPrivateDriverData

Ein Zeiger auf private Daten, der beim Erstellen der Ressource an den Anzeigeminiporttreiber übergeben wurde. Diese Daten sind pro Ressource und nicht pro Zuordnung wie die privaten Daten in der D3DDDI_OPENALLOCATIONINFO-Struktur jeder Zuordnung.

[in] PrivateDriverDataSize

Die Größe der privaten Daten in Bytes, auf die von pPrivateDriverData verwiesen wird.

[in/out] hResource

Ein Handle für die Ressource, die den Zuordnungen zugeordnet ist.

Der Anzeigetreiber für den Benutzermodus sollte dieses Handle speichern und es verwenden, um die Ressource zu identifizieren, sobald der Treiber die Microsoft Direct3D-Runtime zurückruft. Der Benutzermodusanzeigetreiber sollte ein eindeutiges Handle generieren und an die Direct3D-Runtime zurückgeben. Die Direct3D-Runtime verwendet dieses Handle in Treiberaufrufen, um die Ressource zu identifizieren.

[in] Rotation

Ein D3DDDI_ROTATION typisierter Wert, der die Ausrichtung der freigegebenen primären Ressource angibt.

Wenn die primäre Ressource mit einem Vollbildgerät verwendet und gedreht wird, muss der Treiber möglicherweise Zwischenzuordnungen für das Vollbildgerät erstellen. Das Vollbild-Bitfeldflag wird im Flags-Element festgelegt, um anzugeben, dass die primäre Ressource mit einem Vollbildgerät verwendet wird.

[in] Flags

Eine D3DDDI_OPENRESOURCEFLAGS Struktur, die den Typ der zu öffnenden Ressource angibt.

Hinweise

Die Bitfeldflags Primary und SharedResource werden im Flags-Member der D3DDDIARG_CREATERESOURCE-Struktur in einem Aufruf der CreateResource-Funktion festgelegt, um eine freigegebene primäre Ressource zu erstellen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile	d3dumddi.h (include D3dumddi.h)

Weitere Informationen

CreateResource

D3DDDIARG_CREATERESOURCE

D3DDDI_OPENALLOCATIONINFO

D3DDDI_OPENRESOURCEFLAGS

D3DDDI_ROTATION

OpenResource