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

Dimensione, in byte, della struttura dei parametri di input a cui punta pParams .

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 punta pOutputParamsBuffer .

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.

Commenti

La tabella seguente descrive i valori possibili per SubDeviceID, la struttura di input associata a cui punta pParams e la struttura di output che PFND3D10DDI_RETRIEVESUBOBJECT restituisce nel buffer a cui punta pOutputParamsBuffer .

Il runtime Direct3D considera le sottoparti recuperate da aggiungere all'oggetto dispositivo driver Direct3D e prevede che vengano eliminate definitivamente 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.

Requisiti

Vedi anche

DestroyDevice