PFND3D10DDI_CREATESAMPLER función de devolución de llamada (d3d10umddi.h)

Artículo
02/26/2024

La función CreateSampler crea un sampler.

Sintaxis

PFND3D10DDI_CREATESAMPLER Pfnd3d10ddiCreatesampler;

void Pfnd3d10ddiCreatesampler(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D10_DDI_SAMPLER_DESC *unnamedParam2,
  D3D10DDI_HSAMPLER unnamedParam3,
  D3D10DDI_HRTSAMPLER unnamedParam4
)
{...}

Parámetros

unnamedParam1

hDevice [in]

Identificador del dispositivo de visualización (contexto de gráficos).

unnamedParam2

pSamplerDesc [in]

Puntero a una estructura de D3D10_DDI_SAMPLER_DESC que describe los parámetros que usa el controlador de visualización en modo de usuario para crear un sampler.

unnamedParam3

hSampler [in]

Identificador de los datos privados del controlador para el sampler. El controlador devuelve el tamaño, en bytes, de la región de memoria que el tiempo de ejecución de Microsoft Direct3D debe asignar para los datos privados de una llamada a la función CalcPrivateSamplerSize del controlador. El controlador es realmente un puntero a una región de memoria, el tamaño del que solicitó el controlador. El controlador usa esta región de memoria para almacenar estructuras de datos internas relacionadas con su objeto sampler.

unnamedParam4

hRTSampler [in]

Identificador del sampler que el controlador debe usar cada vez que vuelva a llamar al entorno de ejecución de Direct3D.

Valor devuelto

None

Observaciones

El controlador puede usar la función de devolución de llamada pfnSetErrorCb para establecer un código de error.

El controlador puede pasar E_OUTOFMEMORY (si el controlador se queda sin memoria) o D3DDDIERR_DEVICEREMOVED (si se ha quitado el dispositivo) en una llamada a la función pfnSetErrorCb . El tiempo de ejecución de Direct3D determinará que cualquier otro error es crítico. Si el controlador pasa algún error, incluido D3DDDIERR_DEVICEREMOVED, el tiempo de ejecución de Direct3D determinará que el identificador no es válido; Por lo tanto, el tiempo de ejecución no llamará a la función DestroySampler para destruir el identificador que especifica el parámetro hSampler .

El controlador de pantalla en modo de usuario no es necesario para crear más de 4096 instancias únicas de objetos sampler en un dispositivo a la vez.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	d3d10umddi.h (incluya D3d10umddi.h)