PFND3DDDI_GETMULTISAMPLEMETHODLISTCB - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// d3dumddi.h
PFND3DDDI_GETMULTISAMPLEMETHODLISTCB Pfnd3dddiGetmultisamplemethodlistcb;
HRESULT Pfnd3dddiGetmultisamplemethodlistcb(
HANDLE hAdapter,
D3DDDICB_GETMULTISAMPLEMETHODLIST *unnamedParam2
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
The pfnGetMultisampleMethodListCb function retrieves a list of multiple-sample methods that are used for the given width, height, and format of an allocation.
hAdapterA handle to the graphics adapter object.
unnamedParam2pData [in, out]
A pointer to a D3DDDICB_GETMULTISAMPLEMETHODLIST structure that describes the list of multiple-sample methods for an allocation.
pfnGetMultisampleMethodListCb returns one of the following values:
| Return code | Description |
|---|---|
| S_OK | The list of multiple-sample methods was successfully retrieved. |
| E_INVALIDARG | Parameters were validated and determined to be incorrect. |
This function might also return other HRESULT values.
The user-mode display driver typically uses the pfnGetMultisampleMethodListCb function with its CreateResource, CreateResource(D3D10), or CreateResource(D3D11) function and the pfnAllocateCb function. The driver uses pfnGetMultisampleMethodListCb when the Direct3D runtime calls the driver's CreateResource, CreateResource(D3D10), or CreateResource(D3D11) to request that the driver create a multiple-sampled primary. The driver also uses pfnGetMultisampleMethodListCb when it must perform multiple-sampling while scanning out from the primary. This type of multiple-sampling might consume additional memory bandwidth, beyond the bandwidth required for scanning out the display mode. Therefore, pfnGetMultisampleMethodListCb queries the display mode manager (DMM) (and indirectly the display miniport driver) to retrieve a list of supported multiple-sampling methods for the given width, height, and format. If pfnGetMultisampleMethodListCb reports that no methods are supported, the user-mode display driver must use a nonscan-out version of multiple-sampling, typically by creating a standard nonmultiple-sampled primary.
D3DDDICB_GETMULTISAMPLEMETHODLIST