PFND3D10DDI_RETRIEVESUBOBJECT Rückruffunktion (d3d10umddi.h)
Die Direct3D-Laufzeit ruft die PFND3D10DDI_RETRIEVESUBOBJECT-Funktion des Treibers auf, um Unterparts 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 abzurufende Funktionstabelle identifiziert. Siehe Anmerkungen.
ParamSize
Die Größe der Eingabeparameterstruktur in Byte, auf die pParams verweist.
pParams
Ein Zeiger auf eine Eingabeparameterstruktur, die von der SubDeviceID Parameter beschrieben wird. Siehe Anmerkungen.
OutputParamSize
Die Größe in Byte der Ausgabeparameterstruktur, auf die pOutputParamsBuffer verweist.
pOutputParamsBuffer
Ein Zeiger auf eine Ausgabeparameterstruktur, die von der SubDeviceID Parameter beschrieben wird. Siehe Anmerkungen.
Rückgabewert
Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Funktion ein entsprechendes Fehlerergebnis zurück.
Bemerkungen
Die folgende Tabelle beschreibt die möglichen Werte für SubDeviceID, die zugeordnete Eingabestruktur, auf die pParamsverweist, und die Ausgabestruktur, auf die PFND3D10DDI_RETRIEVESUBOBJECT im Puffer zurückgegeben wird, auf pOutputParamsBuffer verweist.
| SubDeviceID | Bedeutung | pParams | pOutputParamsBuffer |
|---|---|---|---|
| 2 | Sub-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 Videofunktionstabelle mit WDDM 2.4 (Windows 10, Version 1803) | D3DWDDM2_4DDI_VIDEO_INPUT_RS4_0 | D3DWDDM2_4DDI_VIDEODEVICEFUNCS_RS4_0 |
Die Direct3D-Laufzeit berücksichtigt, dass die abgerufenen Unterparts an das Direct3D-Treibergeräteobjekt angefügt werden und erwartet, dass sie zusammen mit dem Rest des Geräts zerstört werden, wenn DestroyDevice aufgerufen wird.
Unterverzeichnisse werden unabhängig vom Stammgerätobjekt abgerufen. Die DDI-Schnittstellenversion wird implizit innerhalb der Untergeräte-ID bereitgestellt.
Diese Funktion ist freithreaded.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| mindestens unterstützte Server- | Windows Server 2012 |
| Zielplattform- | Desktop |
| Header- | d3d10umddi.h (include D3d10umddi.h) |