ID3D11DeviceChild::SetPrivateData-Methode (d3d11.h)

  • Artikel

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

Weitere Informationen

ID3D11DeviceChild