COPP 関数から返されるエラー コード

このセクションは、Windows Server 2003 SP1 以降および Windows XP SP2 以降にのみ適用されます。

COPP DDI は、次のタイプのエラー コードを返すことができます。

• winerror.h ヘッダー ファイルで定義され、すべての Windows アプリケーションに共通するエラー コード。 これらの Windows エラー コードは、E_ prefix で始まります。

• ddraw.h ヘッダー ファイルで定義され、DirectDraw に固有のエラー コード。 これらの DirectDraw エラー コードは、DDERR_ prefix で始まります。

COPP DDI に固有のエラー コードはありません。

COPP DDI を実装するときは、Windows エラー コードの使用を次のように制限する必要があります。

• 拡張可能なマーク付け言語 (XML)

  ディスプレイ ドライバーは無効な状態です。 たとえば、COPPKeyExchange 関数の前に、COPPSequenceStart 関数が呼び出された場合などです。

• E_INVALIDARG

  ドライバーに渡される入力パラメーターが無効です。

• E_POINTER

  有効なアドレスを指す出力パラメーターは NULL です。

COPP DDI は E_FAIL および DDERR_GENERIC エラー コードを返すことができます。ただし、エラーの原因を示していないため、使用しないことをお勧めします。

各 COPP 関数の「備考」セクションでは、COPP 関数が報告できる DDERR_ error コードを指定します。 COPP DDI は、他のDDERR_ error コードを返す必要はありません。

ビデオ ミニポート ドライバーの COPP DDI からディスプレイ ドライバーにエラー情報を伝達する場合、Windows カーネルは、IOCTL から EngDeviceIoControl に返されるエラー値を操作するため、EngDeviceIoControl 関数からの戻り値を使用しないでください。 代わりに、EngDeviceIoControl の lpInBuffer パラメーターを介してエラー情報を渡す必要があります。 詳細については、「ディスプレイ ドライバーからの COPP DDI の呼び出し」、「COPP ビデオ ミニポート ドライバー テンプレート」および「COPP 操作の実行」のコード例を参照してください。