PFND3D10DDI_RETRIEVESUBOBJECT Rückruffunktion (d3d10umddi.h)
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) |