ID3D11DeviceChild::SetPrivateData-Methode (d3d11.h)
Legen Sie anwendungsdefinierte Daten auf ein untergeordnetes Gerät fest, und ordnen Sie diese Daten einer anwendungsdefinierten 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 mit diesem untergeordneten Gerät gespeichert werden sollen. Wenn pData NULL ist, muss DataSize ebenfalls 0 sein, und alle Daten, die zuvor der angegebenen GUID zugeordnet waren, werden zerstört.
Rückgabewert
Typ: HRESULT
Diese Methode gibt einen der folgenden Direct3D 11-Rückgabecodes zurück.
Hinweise
Die im untergeordneten Gerät gespeicherten Daten mit dieser Methode können mit ID3D11DeviceChild::GetPrivateData abgerufen werden.
Die Debugebene meldet Speicherverluste, indem eine Liste von Objektschnittstellenzeigern zusammen mit ihren Anzeigenamen ausgegeben wird. Der Standardanzeigename 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" zuzuweisen:
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 |