IDirect3DDevice9::GetRasterStatus Method

Returns information describing the raster of the monitor on which the swap chain is presented.

Syntax

HRESULT GetRasterStatus(      

    UINT iSwapChain,
    D3DRASTER_STATUS *pRasterStatus
);

Parameters

iSwapChain

[in] An unsigned integer specifying the swap chain.

pRasterStatus

[out] Pointer to a D3DRASTER_STATUS structure filled with information about the position or other status of the raster on the monitor driven by this adapter.

Return Value

If the method succeeds, the return value is D3D_OK.

D3DERR_INVALIDCALL is returned if pRasterStatus is invalid or if the device does not support reading the current scan line. To determine if the device supports reading the scan line, check for the D3DCAPS_READ_SCANLINE flag in the Caps member of D3DCAPS9.

Remarks

This method will not return device state for a device that is created using D3DCREATE_PUREDEVICE. If you want to use this method, you must create your device with any of the other values in D3DCREATE."

See Also

D3DRASTER_STATUS