D3D11_1DDI_GETCAPTUREHANDLEDATA-Struktur (d3d10umddi.h)

Definiert eine Ressourcenzuordnung in einem Aufruf der GetCaptureHandle-Funktion .

Syntax

typedef struct _D3D11_1DDI_GETCAPTUREHANDLEDATA {
  [in]  D3D10DDI_HRESOURCE hResource;
  [in]  UINT               ArrayIndex;
  [out] D3DKMT_HANDLE      hAllocation;
  [out] UINT               DataOffset;
  [out] UINT               DataSize;
} D3D11_1DDI_GETCAPTUREHANDLEDATA;

Member

[in] hResource

Das Handle für die Ressource, für die das Zuordnungshandle abgerufen werden soll.

Die Direct3D-Runtime, Version 11 und höher, hat bereits überprüft, ob diese Ressource mithilfe des D3D11_DDI_BIND_CAPTURE-Werts in der D3D10_DDI_RESOURCE_BIND_FLAG-Enumeration erstellt wurde.

[in] ArrayIndex

Das Arrayelement, aus dem die Daten abgerufen werden sollen.

Wenn die Ressource nicht als Texturarray erstellt wurde, ist dieser Wert null. Für ein Texturarray hat die Direct3D-Runtime, Version 11 und höher, bereits überprüft, ob das Array gültig ist.

[out] hAllocation

Die vom Treiber bereitgestellte Adresse des Kernelmoduszuordnungshandles, das dieser Zuordnung zugeordnet ist.

[out] DataOffset

Der vom Treiber bereitgestellte Offset der angeforderten Daten innerhalb der Zuordnung.

Wenn die Ressource nicht als Texturarray erstellt wurde, ist dieser Wert in der Regel null. Bei einem Texturarray ist dieser Wert der Offset der Arrayelementdaten innerhalb der Zuordnung.

[out] DataSize

Die vom Treiber bereitgestellte Größe der angeforderten Daten innerhalb der Zuordnung.

Wenn die Ressource nicht als Texturarray erstellt wurde, entspricht dieser Wert in der Regel der Größe der Zuordnung in Bytes. Bei einem Texturarray ist dieser Wert die Größe der Elementdaten innerhalb der Zuordnung.

Hinweise

Wenn die GetCaptureHandle-Funktion aufgerufen wird, aktualisiert der Treiber die Struktur mit dem Der angegebenen Ressource zugeordneten Kernelmoduszuordnungshandle sowie der Größe der Ressourcendaten und deren Offset innerhalb eines zugeordneten Speicherblocks.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Kopfzeile d3d10umddi.h (include D3d10umddi.h)

Weitere Informationen

D3D10_DDI_RESOURCE_BIND_FLAG

GetCaptureHandle