ID3D11Device::SetPrivateData-Methode (d3d11.h)

Legen Sie Daten auf ein Gerät fest, und ordnen Sie diese Daten einer GUID zu.

Syntax

HRESULT SetPrivateData(
  [in]           REFGUID    guid,
  [in]           UINT       DataSize,
  [in, optional] const void *pData
);

Parameter

[in] guid

Typ: REFGUID

Guid, die den Daten zugeordnet ist.

[in] DataSize

Typ: UINT

Größe der Daten.

[in, optional] pData

Typ: const void*

Zeiger auf die Daten, die auf diesem Gerät gespeichert werden sollen. Wenn pData NULL ist, muss DataSize ebenfalls 0 sein, und alle Daten, die zuvor der GUID zugeordnet sind, werden zerstört.

Rückgabewert

Typ: HRESULT

Diese Methode gibt einen der folgenden Direct3D 11-Rückgabecodes zurück.

Hinweise

Die auf dem Gerät mit dieser Methode gespeicherten Daten können mit ID3D11Device::GetPrivateData abgerufen werden.

Die Mit dieser Methode festgelegten Daten und guid werden in der Regel von der Anwendung definiert.

Die Debugebene meldet Speicherverluste, indem eine Liste von Objektschnittstellenzeigern zusammen mit ihren Anzeigenamen ausgegeben wird. Der Standard-Anzeigename ist "<unbenannt>". Sie können den Anzeigenamen festlegen, damit Sie ermitteln können, ob der entsprechende Objektschnittstellenzeiger das Leck verursacht hat. Verwenden Sie zum Festlegen des Anzeigenamens die SetPrivateData-Methode und die WKPDID_D3DDebugObjectName GUID in D3Dcommon.h. Verwenden Sie beispielsweise den folgenden Code, um pContext den Anzeigenamen "Mein Name" zu geben:


static const char c_szName[] = "My name";
hr = pContext->SetPrivateData( WKPDID_D3DDebugObjectName, sizeof( c_szName ) - 1, c_szName );

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile d3d11.h
Bibliothek D3D11.lib

Weitere Informationen

ID3D11Device