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;
Angehörige
[in] NumAllocations
Die Anzahl der Elemente im Array, die durch pOpenAllocationInfoangegeben wird. NumAllocations die Anzahl der zu öffnenden Zuordnungen darstellt.
[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
Dieses Element ist reserviert und sollte auf 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 über einen Aufruf der CreateResource--Funktion des Anzeigetreibers im Benutzermodus erstellt wurde.
[in] pPrivateDriverData
Ein Zeiger auf private Daten, die beim Erstellen der Ressource an den Anzeigeminiporttreiber übergeben wurden. 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 durch 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 verwenden, um die Ressource jederzeit zu identifizieren, wenn der Treiber wieder in die Microsoft Direct3D-Laufzeit aufruft. Der Anzeigetreiber für den Benutzermodus sollte ein eindeutiges Handle generieren und an die Direct3D-Laufzeit übergeben. Die Direct3D-Laufzeit verwendet dieses Handle in Treiberaufrufen, um die Ressource zu identifizieren.
[in] Rotation
Ein D3DDDI_ROTATION-typed-Wert, der die Ausrichtung der freigegebenen primären Ressource identifiziert.
Wenn die primäre Ressource mit einem Vollbildgerät verwendet und gedreht wird, muss der Treiber möglicherweise Zwischenzuweisungen für die Verarbeitung des Vollbildgeräts erstellen. Das Vollbild- Bitfeldflagge wird im Flags Member 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 identifiziert.
Bemerkungen
Die Primären und SharedResource- Bitfeldkennzeichnungen 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Header- | d3dumddi.h (include D3dumddi.h) |