PFND3D10DDI_CREATERASTERIZERSTATE コールバック関数 (d3d10umddi.h)
CreateRasterizerState 関数はラスタライザーの状態を作成します。
構文
PFND3D10DDI_CREATERASTERIZERSTATE Pfnd3d10ddiCreaterasterizerstate;
void Pfnd3d10ddiCreaterasterizerstate(
D3D10DDI_HDEVICE unnamedParam1,
const D3D10_DDI_RASTERIZER_DESC *unnamedParam2,
D3D10DDI_HRASTERIZERSTATE unnamedParam3,
D3D10DDI_HRTRASTERIZERSTATE unnamedParam4
)
{...}
パラメーター
unnamedParam1
hDevice [in]
ディスプレイ デバイスへのハンドル (グラフィックス コンテキスト)。
unnamedParam2
pRasterizerDesc [in]
ユーザー モード ディスプレイ ドライバーがラスタライザーの状態を作成するために使用するパラメーターを記述する D3D10_DDI_RASTERIZER_DESC構造体への ポインター。
unnamedParam3
hRasterizerState [in]
ラスタライザー状態のドライバーのプライベート データへのハンドル。 ドライバーは、Microsoft Direct3D ランタイムがドライバーの CalcPrivateRasterizerStateSize 関数の呼び出しからプライベート データに割り当てる必要があるメモリ領域のサイズをバイト単位で返します。 ハンドルは、実際には、ドライバーが要求したサイズであるメモリ領域へのポインターにすぎません。 ドライバーは、このメモリ領域を使用して、ラスタライザー状態オブジェクトに関連する内部データ構造を格納します。
unnamedParam4
hRTRasterizerState [in]
ドライバーが Direct3D ランタイムに呼び出す場合にいつでも使用する必要があるラスタライザー状態のハンドル。
戻り値
なし
解説
ドライバーは、 pfnSetErrorCb コールバック関数を使用してエラー コードを設定できます。
ドライバーは、E_OUTOFMEMORY (ドライバーがメモリ不足の場合) または D3DDDIERR_DEVICEREMOVED (デバイスが削除されている場合) を pfnSetErrorCb 関数の呼び出しで渡すことができます。 Direct3D ランタイムは、他のエラーが重大であると判断します。 ドライバーがD3DDDIERR_DEVICEREMOVEDなどのエラーを渡した場合、Direct3D ランタイムはハンドルが無効であると判断します。そのため、ランタイムは DestroyRasterizerState 関数を呼び出して 、hRasterizerState パラメーターが指定するハンドルを破棄しません。
ユーザー モード ディスプレイ ドライバーは、一度に 4,096 を超えるラスタライザー状態オブジェクトの一意のインスタンスをデバイスに作成する必要はありません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | d3d10umddi.h (D3d10umddi.h を含む) |