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 |