PFND3D10DDI_RETRIEVESUBOBJECT funzione di callback (d3d10umddi.h)
Il runtime Direct3D chiama la funzione PFND3D10DDI_RETRIEVESUBOBJECT del driver per recuperare le sottoparti dell'oggetto dispositivo driver Direct3D.
Sintassi
PFND3D10DDI_RETRIEVESUBOBJECT Pfnd3d10ddiRetrievesubobject;
HRESULT Pfnd3d10ddiRetrievesubobject(
D3D10DDI_HDEVICE unnamedParam1,
UINT32 SubDeviceID,
SIZE_T ParamSize,
void *pParams,
SIZE_T OutputParamSize,
void *pOutputParamsBuffer
)
{...}
Parametri
unnamedParam1
hDevice [in] Handle per il dispositivo di visualizzazione (contesto grafico).
SubDeviceID
ID dispositivo secondario che identifica la tabella delle funzioni recuperata. Vedere la sezione Osservazioni.
ParamSize
Dimensioni, in byte, della struttura dei parametri di input a cui pParams punta.
pParams
Puntatore a una struttura di parametri di input descritta dal parametro SubDeviceID. Vedere la sezione Osservazioni.
OutputParamSize
Dimensioni, in byte, della struttura dei parametri di output a cui pOutputParamsBuffer punta.
pOutputParamsBuffer
Puntatore a una struttura di parametri di output descritta dal parametro SubDeviceID. Vedere la sezione Osservazioni.
Valore restituito
Restituisce S_OK se l'operazione ha esito positivo. In caso contrario, questa funzione restituisce un risultato di errore appropriato.
Osservazioni
Nella tabella seguente vengono descritti i valori possibili per SubDeviceID, la struttura di input associata a cui punta pParamse la struttura di output che PFND3D10DDI_RETRIEVESUBOBJECT restituisce nel buffer a cui punta pOutputParamsBuffer .
| SubDeviceID | Significato | pParams | pOutputParamsBuffer |
|---|---|---|---|
| 2 | ID secondario per una tabella delle funzioni video D3D 11. | D3D11_1DDI_VIDEO_INPUT | D3D11_1DDI_VIDEODEVICEFUNCS |
| 3 | ID secondario per una tabella di funzioni video WDDM 2.0. | D3DWDDM2_0DDI_VIDEO_INPUT | D3DWDDM2_0DDI_VIDEODEVICEFUNCS |
| 5 | ID secondario per una tabella di funzioni video WDDM 2.1. | D3DWDDM2_1DDI_VIDEO_INPUT | D3DWDDM2_1DDI_VIDEODEVICEFUNCS . |
| 6 | ID secondario per una tabella di funzioni video WDDM 2.4 e successive. Supportato a partire da WDDM 2.4. | D3DWDDM2_4DDI_VIDEO_INPUT | D3DWDDM2_4DDI_VIDEODEVICEFUNCS. |
| 7 | ID secondario per una tabella di funzioni video WDDM 2.4 (versione 1803 di Windows 10 versione 1803). | D3DWDDM2_4DDI_VIDEO_INPUT_RS4_0 | D3DWDDM2_4DDI_VIDEODEVICEFUNCS_RS4_0 |
Il runtime Direct3D considera le sottoparti recuperate da aggiungere all'oggetto dispositivo driver Direct3D e prevede che vengano distrutte insieme al resto del dispositivo quando viene chiamato DestroyDevice.
I sottodispositivi vengono recuperati dall'oggetto dispositivo radice in modo indipendente. La versione dell'interfaccia DDI viene fornita in modo implicito all'interno dell'ID del dispositivo secondario.
Questa funzione è a thread libero.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 8 |
| server minimo supportato | Windows Server 2012 |
| piattaforma di destinazione | Desktop |
| intestazione | d3d10umddi.h (include D3d10umddi.h) |