PFND3D10DDI_RETRIEVESUBOBJECT fonction de rappel (d3d10umddi.h)
Le runtime Direct3D appelle la fonction PFND3D10DDI_RETRIEVESUBOBJECT du pilote pour récupérer les sous-parties de l’objet de périphérique du pilote Direct3D.
Syntaxe
PFND3D10DDI_RETRIEVESUBOBJECT Pfnd3d10ddiRetrievesubobject;
HRESULT Pfnd3d10ddiRetrievesubobject(
D3D10DDI_HDEVICE unnamedParam1,
UINT32 SubDeviceID,
SIZE_T ParamSize,
void *pParams,
SIZE_T OutputParamSize,
void *pOutputParamsBuffer
)
{...}
Paramètres
unnamedParam1
hDevice [in] Handle vers l’appareil d’affichage (contexte graphique).
SubDeviceID
ID de sous-appareil qui identifie la table de fonctions récupérée. Voir les remarques.
ParamSize
Taille, en octets, de la structure de paramètres d’entrée vers laquelle pParams pointe.
pParams
Pointeur vers une structure de paramètres d’entrée décrite par le paramètre SubDeviceID. Voir les remarques.
OutputParamSize
Taille, en octets, de la structure de paramètres de sortie vers laquelle pOutputParamsBu ffer pointe vers.
pOutputParamsBuffer
Pointeur vers une structure de paramètres de sortie décrite par le paramètre SubDeviceID. Voir les remarques.
Valeur de retour
Retourne S_OK si l’opération réussit. Sinon, cette fonction retourne un résultat d’erreur approprié.
Remarques
Le tableau suivant décrit les valeurs possibles pour SubDeviceID, la structure d’entrée associée pointée par pParams et la structure de sortie qui PFND3D10DDI_RETRIEVESUBOBJECT retourne dans la mémoire tampon pointée par pOutputParamsBuffer.
| SubDeviceID | Signification | pParams | pOutputParamsBuffer |
|---|---|---|---|
| 2 | Sous-ID d’une table de fonctions vidéo D3D 11. | D3D11_1DDI_VIDEO_INPUT | D3D11_1DDI_VIDEODEVICEFUNCS |
| 3 | Sous-ID d’une table de fonctions vidéo WDDM 2.0. | D3DWDDM2_0DDI_VIDEO_INPUT | D3DWDDM2_0DDI_VIDEODEVICEFUNCS |
| 5 | Sous-ID d’une table de fonctions vidéo WDDM 2.1. | D3DWDDM2_1DDI_VIDEO_INPUT | D3DWDDM2_1DDI_VIDEODEVICEFUNCS . |
| 6 | Sous-ID pour une table de fonctions vidéo WDDM 2.4 et ultérieures. Prise en charge à partir de WDDM 2.4. | D3DWDDM2_4DDI_VIDEO_INPUT | D3DWDDM2_4DDI_VIDEODEVICEFUNCS. |
| 7 | Sous-ID d’une table de fonctions vidéo WDDM 2.4 (Windows 10 version 1803). | D3DWDDM2_4DDI_VIDEO_INPUT_RS4_0 | D3DWDDM2_4DDI_VIDEODEVICEFUNCS_RS4_0 |
Le runtime Direct3D considère que les sous-parties récupérées doivent être ajoutées à l’objet de périphérique du pilote Direct3D et s’attend à ce qu’elles soient détruites avec le reste de l’appareil lorsque DestroyDevice est appelé.
Les sous-appareils sont récupérés de l’objet d’appareil racine indépendamment. La version de l’interface DDI est fournie implicitement dans l’ID de sous-appareil.
Cette fonction est thread libre.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 |
| serveur minimum pris en charge | Windows Server 2012 |
| plateforme cible | Bureau |
| d’en-tête | d3d10umddi.h (include D3d10umddi.h) |