PFND3D11DDI_COPYSTRUCTURECOUNT Rückruffunktion (d3d10umddi.h)
Die CopyStructureCount--Funktion kopiert die Anzahl der Elemente im gefüllten Teil (d. h. den Wert der gefüllten Größe) eines Anfügepuffers ungeordneter Zugriffsansicht (UAV) in einen Offset in einen Zielpuffer.
Syntax
PFND3D11DDI_COPYSTRUCTURECOUNT Pfnd3d11ddiCopystructurecount;
void Pfnd3d11ddiCopystructurecount(
D3D10DDI_HDEVICE unnamedParam1,
D3D10DDI_HRESOURCE unnamedParam2,
UINT unnamedParam3,
D3D11DDI_HUNORDEREDACCESSVIEW unnamedParam4
)
{...}
Parameter
unnamedParam1
hDevice [in]
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
hDstBuffer [in]
Ein Handle für einen Zielpuffer zum Kopieren des Werts der gefüllten Größe eines UAV in. Zum Erstellen dieses Zielpuffers muss die Laufzeit zuvor die CreateResource(D3D11)- Funktion des Treibers mit dem ResourceDimension Member der D3D11DDIARG_CREATERESOURCE-Struktur aufgerufen haben, die auf den D3D10DDIRESOURCE_BUFFER Wert festgelegt ist.
unnamedParam3
DstAlignedByteOffset [in]
Der 4-Byte-Offset in Bytes in den Zielpuffer, den der hDstBuffer Parameter angibt. CopyStructureCount kopiert den Wert der Anfügepufferansicht, den der hSrcView Parameter in hDstBufferangibt. DstAlignedByteOffset- muss ein Vielfaches von vier sein.
unnamedParam4
hSrcView [in]
Ein Handle an die Quellanfüge-UAV, die eine Anfügepufferansicht sein muss. CopyStructureCount kopiert den Wert dieser Ansicht in den Zielpuffer, den der hDstBuffer Parameter angibt. Zum Erstellen dieser Anfügepufferansicht muss die Laufzeit zuvor die CreateUnorderedAccessView-Funktion des Treibers mit dem D3D11_DDI_BUFFER_UAV_FLAG_APPEND Flagsatz aufgerufen haben.
Rückgabewert
Nichts
Bemerkungen
Der Treiber kann die pfnSetErrorCb Rückruffunktion verwenden, um einen Fehlercode festzulegen.
Der Treiber sollte keinen Fehler haben, mit Ausnahme von D3DDDIERR_DEVICEREMOVED. Wenn der Treiber daher einen Fehler außer D3DDDIERR_DEVICEREMOVED übergibt, bestimmt die Direct3D-Laufzeit in einem Aufruf der pfnSetErrorCb--Funktion, dass der Fehler kritisch ist. Auch wenn das Gerät entfernt wird, ist der Treiber nicht erforderlich, um D3DDDIERR_DEVICEREMOVED zurückzugeben; Wenn das Entfernen des Geräts jedoch den Betrieb von CopyStructureCount beeinträchtigt (was normalerweise nicht geschehen sollte), kann der Treiber D3DDDIERR_DEVICEREMOVED zurückgeben.
CopyStructureCount übernimmt den Wert für den Anfügepuffer UAV (eine UAV, die Push- und Popupvorgänge auf Strukturen wie in einem Stapel unterstützt) und kopiert diesen Wert in einen Offset in den Zielpuffer. Die Grafikhardware verwendet einen 4-Byte-Wert für gefüllte Größe, um nachzuverfolgen, wie viele Daten im Anfügepuffer UAV gefüllt sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | CopyStructureCount wird beginnend mit dem Windows 7-Betriebssystem unterstützt. |
| Zielplattform- | Desktop |
| Header- | d3d10umddi.h (include D3d10umddi.h) |