Compartilhar via


PFND3D10DDI_RETRIEVESUBOBJECT função de retorno de chamada (d3d10umddi.h)

O runtime do Direct3D chama a função PFND3D10DDI_RETRIEVESUBOBJECT do driver para recuperar subpartes do objeto de dispositivo do driver Direct3D.

Sintaxe

PFND3D10DDI_RETRIEVESUBOBJECT Pfnd3d10ddiRetrievesubobject;

HRESULT Pfnd3d10ddiRetrievesubobject(
  D3D10DDI_HDEVICE unnamedParam1,
  UINT32 SubDeviceID,
  SIZE_T ParamSize,
  void *pParams,
  SIZE_T OutputParamSize,
  void *pOutputParamsBuffer
)
{...}

Parâmetros

unnamedParam1

hDevice [in] Um identificador para o dispositivo de exibição (contexto gráfico).

SubDeviceID

ID do subprojeto que identifica a tabela de funções que está sendo recuperada. Consulte Observações.

ParamSize

O tamanho, em bytes, da estrutura de parâmetro de entrada para a qual pParams aponta.

pParams

Um ponteiro para uma estrutura de parâmetro de entrada descrita pelo parâmetro SubDeviceID . Consulte Observações.

OutputParamSize

O tamanho, em bytes, da estrutura de parâmetro de saída para a qual pOutputParamsBuffer aponta.

pOutputParamsBuffer

Um ponteiro para uma estrutura de parâmetro de saída descrita pelo parâmetro SubDeviceID . Consulte Observações.

Valor retornado

Retorna S_OK se a operação for bem-sucedida. Caso contrário, essa função retornará um resultado de erro apropriado.

Comentários

A tabela a seguir descreve os valores possíveis para SubDeviceID, a estrutura de entrada associada apontada por pParams e a estrutura de saída que PFND3D10DDI_RETRIEVESUBOBJECT retorna no buffer apontado por pOutputParamsBuffer .

SubDeviceID Significado pParams pOutputParamsBuffer
2 Sub ID de uma tabela de funções de vídeo D3D 11. D3D11_1DDI_VIDEO_INPUT D3D11_1DDI_VIDEODEVICEFUNCS
3 Sub ID de uma tabela de funções de vídeo WDDM 2.0. D3DWDDM2_0DDI_VIDEO_INPUT D3DWDDM2_0DDI_VIDEODEVICEFUNCS
5 Sub ID de uma tabela de funções de vídeo WDDM 2.1. D3DWDDM2_1DDI_VIDEO_INPUT D3DWDDM2_1DDI_VIDEODEVICEFUNCS .
6 Sub ID de uma tabela de funções de vídeo WDDM 2.4 e posterior. Com suporte a partir do WDDM 2.4. D3DWDDM2_4DDI_VIDEO_INPUT D3DWDDM2_4DDI_VIDEODEVICEFUNCS.
7 Sub ID de uma tabela de funções de vídeo WDDM 2.4 (versão Windows 10 versão 1803). D3DWDDM2_4DDI_VIDEO_INPUT_RS4_0 D3DWDDM2_4DDI_VIDEODEVICEFUNCS_RS4_0

O runtime do Direct3D considera que as subpartes recuperadas sejam acrescentadas ao objeto de dispositivo do driver Direct3D e espera que elas sejam destruídas junto com o restante do dispositivo quando DestroyDevice for chamado.

Os subdispositivos são recuperados do objeto de dispositivo raiz de forma independente. A versão da interface DDI é fornecida implicitamente dentro da ID do sub-dispositivo.

Essa função é de thread livre.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Área de Trabalho
Cabeçalho d3d10umddi.h (inclua D3d10umddi.h)

Confira também

DestroyDevice