Freigeben über


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;

Angehörige

[in] hResource

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

Die Direct3D-Version 11 und höher haben bereits überprüft, ob diese Ressource mithilfe des D3D11_DDI_BIND_CAPTURE Werts in der D3D10_DDI_RESOURCE_BIND_FLAG-Aufzählung 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. Bei einem Texturarray hat die Direct3D-Version 11 und höher bereits überprüft, ob das Array gültig ist.

[out] hAllocation

Die vom Treiber bereitgestellte Adresse des Zuordnungshandle für den Kernelmodus, der 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, ist dieser Wert in der Regel die Größe der Zuordnung in Byte. Bei einem Texturarray ist dieser Wert die Größe der Elementdaten innerhalb der Zuordnung.

Bemerkungen

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

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 8
mindestens unterstützte Server- Windows Server 2012
Header- d3d10umddi.h (include D3d10umddi.h)

Siehe auch

D3D10_DDI_RESOURCE_BIND_FLAG

GetCaptureHandle-