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) |