Share via

PFND3D10DDI_RETRIEVESUBOBJECT Rückruffunktion (d3d10umddi.h)

  • Artikel

Die Direct3D-Runtime ruft die PFND3D10DDI_RETRIEVESUBOBJECT-Funktion des Treibers auf, um Teilteile des Direct3D-Treibergeräteobjekts abzurufen.

Syntax

PFND3D10DDI_RETRIEVESUBOBJECT Pfnd3d10ddiRetrievesubobject;

HRESULT Pfnd3d10ddiRetrievesubobject(
  D3D10DDI_HDEVICE unnamedParam1,
  UINT32 SubDeviceID,
  SIZE_T ParamSize,
  void *pParams,
  SIZE_T OutputParamSize,
  void *pOutputParamsBuffer
)
{...}

Parameter

unnamedParam1

hDevice [in] Ein Handle für das Anzeigegerät (Grafikkontext).

SubDeviceID

Untergeräte-ID, die die abgerufene Funktionstabelle identifiziert. Siehe Hinweise.

ParamSize

Die Größe der Eingabeparameterstruktur in Bytes, auf die pParams verweist.

pParams

Ein Zeiger auf eine Eingabeparameterstruktur, die vom SubDeviceID-Parameter beschrieben wird. Siehe Hinweise.

OutputParamSize

Die Größe der Ausgabeparameterstruktur in Bytes, auf die pOutputParamsBuffer verweist.

pOutputParamsBuffer

Ein Zeiger auf eine Ausgabeparameterstruktur, die durch den SubDeviceID-Parameter beschrieben wird. Siehe Hinweise.

Rückgabewert

Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion ein entsprechendes Fehlerergebnis zurück.

Hinweise

In der folgenden Tabelle werden die möglichen Werte für SubDeviceID, die zugeordnete Eingabestruktur, auf die pParams verweist, und die Ausgabestruktur beschrieben, die PFND3D10DDI_RETRIEVESUBOBJECT im Puffer zurückgibt, auf den pOutputParamsBuffer verweist.

SubDeviceID Bedeutung pParams pOutputParamsBuffer
2 Unter-ID für eine D3D 11-Videofunktionstabelle. D3D11_1DDI_VIDEO_INPUT D3D11_1DDI_VIDEODEVICEFUNCS
3 Unter-ID für eine WDDM 2.0-Videofunktionstabelle. D3DWDDM2_0DDI_VIDEO_INPUT D3DWDDM2_0DDI_VIDEODEVICEFUNCS
5 Unter-ID für eine WDDM 2.1-Videofunktionstabelle. D3DWDDM2_1DDI_VIDEO_INPUT D3DWDDM2_1DDI_VIDEODEVICEFUNCS .
6 Unter-ID für eine WDDM 2.4- und höher-Videofunktionstabelle. Wird ab WDDM 2.4 unterstützt. D3DWDDM2_4DDI_VIDEO_INPUT D3DWDDM2_4DDI_VIDEODEVICEFUNCS.
7 Unter-ID für eine WDDM 2.4-Videofunktionstabelle (Windows 10 Version 1803). D3DWDDM2_4DDI_VIDEO_INPUT_RS4_0 D3DWDDM2_4DDI_VIDEODEVICEFUNCS_RS4_0

Die Direct3D-Runtime berücksichtigt, dass die abgerufenen Unterteile an das Direct3D-Treibergerätobjekt angefügt werden und erwartet, dass sie zusammen mit dem Rest des Geräts zerstört werden, wenn DestroyDevice aufgerufen wird.

Untergeräte werden unabhängig vom Stammgerätobjekt abgerufen. Die DDI-Schnittstellenversion wird implizit in der Untergeräte-ID bereitgestellt.

Diese Funktion ist Freithreading.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Desktop
Kopfzeile d3d10umddi.h (einschließlich D3d10umddi.h)

Weitere Informationen

DestroyDevice