Microsoft DirectX 8.0 (C++)

戻り値

エラーは負の値で表され、それらを組み合わせることはできない。

次の表は、以降で示すエラー値が適用されるインターフェイスのリストである。

インターフェイス インターフェイス
IDirectPlay8Address IDirectPlay8Peer
IDirectPlay8AddressIP IDirectPlay8Server
IDirectPlay8Client IDirectPlayVoiceClient
IDirectPlay8LobbiedApplication IDirectPlayVoiceServer
IDirectPlay8LobbyClient IDirectPlayVoiceTest

各メソッドにより返されるエラー値については、個別のメソッドの説明を参照すること。

Microsoft® DirectPlay® のサンプルの多くには、HRESULT 値を DirectPlay エラーの文字列名に変換する GetDirectPlayErrStr 関数が含まれている。開発者は、診断トレースやエラー レポート用に各自のアプリケーションにこのコードをコピーできる。

成功コード

DPNSUCCESS_PENDING
非同期処理で、キューへの設定が成功するところまで処理が進んだ。
S_OK
操作は正常に終了した。

エラー コード

DPNERR_ABORTED
操作は、完了前に取り消された。
DPNERR_ADDRESSING
指定されたアドレスが無効である。
DPNERR_ALREADYCONNECTED
オブジェクトはすでにセッションに接続されている。
DPNERR_ALREADYCLOSING
セッションでの Close メソッド呼び出しが複数回行われた。
DPNERR_ALREADYDISCONNECTING
クライアントはすでにセッションから接続解除している。
DPNERR_ALREADYINITIALIZED
オブジェクトは既に初期化されている。
DPNERR_BUFFERTOOSMALL
指定されたバッファが、要求されたデータを格納するのに十分な大きさでない。
DPNERR_CANNOTCANCEL
操作を取り消すことができなかった。
DPNERR_CANTCREATEGROUP
新しいグループを作成できない。
DPNERR_CANTCREATEPLAYER
新しいプレーヤーを作成できない。
DPNERR_CANTLAUNCHAPPLICATION
ロビーは指定されたアプリケーションを起動できない。
DPNERR_CONNECTING
このメソッドは、ネットワークに接続中である。
DPNERR_CONNECTIONLOST
データの送信中にサービス プロバイダ接続がリセットされた。
DPNERR_DATATOOLARGE
アプリケーション データが、サービス プロバイダの MTU (Maximum Transmission Unit) に対して大きすぎる。
DPNERR_DOESNOTEXIST
要求された要素はアドレスの一部ではない。
DPNERR_ENUMQUERYTOOLARGE
指定されたクエリ データが大きすぎる。
DPNERR_ENUMRESPONSETOOLARGE
列挙クエリへの応答が大きすぎる。
DPNERR_EXCEPTION
要求処理時に例外が発生した。
DPNERR_GENERIC
未定義エラー条件が発生した。
DPNERR_GROUPNOTEMPTY
指定されたグループが空ではない。
DPNERR_HOSTREJECTEDCONNECTION
DPN_MSGID_INDICATE_CONNECT システム メッセージが、接続要求に対して S_OK 以外の値を返した。
DPNERR_HOSTTERMINATEDSESSION
ピアツーピア セッションのホスト (ホストの移行が可能) がセッションを終了した。
DPNERR_INCOMPLETEADDRESS
指定されたアドレスが不完全である。
DPNERR_INVALIDADDRESSFORMAT
アドレス フォーマットが無効である。
DPNERR_INVALIDAPPLICATION
アプリケーションに指定された GUID が無効である。
DPNERR_INVALIDCOMMAND
指定されたコマンドが無効である。
DPNERR_INVALIDDEVICEADDRESS
ローカル コンピュータまたはアダプタのアドレスが無効である。
DPNERR_INVALIDFLAGS
このメソッドに渡されたフラグが無効であった。
DPNERR_INVALIDGROUP
グループ ID が、このゲーム セッションの有効なグループ ID として認識されない。
DPNERR_INVALIDHANDLE
指定されたハンドルは無効である。
DPNERR_INVALIDHOSTADDRESS
指定されたリモート アドレスが無効である。
DPNERR_INVALIDINSTANCE
アプリケーションのインスタンスの GUID が無効である。
DPNERR_INVALIDINTERFACE
インターフェイス パラメータが無効である。接続元プレーヤーがクライアント/サーバー ゲームのクライアントまたはピアツーピア ゲームのピアではなかった場合、接続要求にこの値が返される。
DPNERR_INVALIDOBJECT
DirectPlay オブジェクト ポインタが無効である。
DPNERR_INVALIDPARAM
メソッドに渡されたパラメータのいずれかまたはいくつかが無効である。
DPNERR_INVALIDPASSWORD
パスワードが必要なセッションに参加しようとしたときに、無効なパスワードが指定された。
DPNERR_INVALIDPLAYER
プレーヤー ID がこのゲーム セッションの有効なプレーヤー ID として認識されない。
DPNERR_INVALIDPOINTER
パラメータとして指定されたポインタが無効である。
DPNERR_INVALIDPRIORITY
指定された優先順位が、許可されている優先順位の範囲 (0 以上 65535 以下) 外である。
DPNERR_INVALIDSTRING
パラメータとして指定された文字列が無効である。
DPNERR_INVALIDURL
指定された文字列が無効な DirectPlay URL である。
DPNERR_INVALIDVERSION
DirectPlay の無効なバージョンに接続しようとした。
DPNERR_NOCAPS
DirectPlay が使用しようとしている通信リンクでは、この機能を使用できない。
DPNERR_NOCONNECTION
通信リンクが確立されなかった。
DPNERR_NOHOSTPLAYER
現在、セッションのホストとして機能するプレーヤーがない。
DPNERR_NOINTERFACE
インターフェイスがサポートされていない。
DPNERR_NORESPONSE
指定されたターゲットから応答がない。
DPNERR_NOTALLOWED
オブジェクトは読み取り専用である。このオブジェクトに対してこの機能は使用できない。
DPNERR_NOTHOST
クライアントがホスト以外のコンピュータに接続しようとした。また、ホスト以外のコンピュータがアプリケーションの記述を設定しようとした場合に、このエラー値が返されることがある。
DPNERR_OUTOFMEMORY
要求された操作を実行するには、メモリが不足している。
DPNERR_PENDING
エラーではない。この戻り値は、非同期処理で、キューへの設定が成功するところまで処理が進んだことを示す。SUCCEEDED(DPNERR_PENDING) は TRUE を返す。このエラー値は、DPNERR_SUCCESS で置き換えられている。新しいアプリケーションでは、DPNERR_SUCCESS を使用すべきである。DPNERR_PENDING は、下位互換性を保つために導入されている。
DPNERR_PLAYERLOST
プレーヤーは、セッションへの接続を喪失した。
DPNERR_PLAYERNOTREACHABLE
セッション内で少なくともほかの一人の既存プレーヤーが、参加中のプレーヤーに接続できない状態のピアツーピア セッションに、プレーヤーが参加しようとした。
DPNERR_SESSIONFULL
セッションに割り当てられているプレーヤーの最大数に達したため、ホストまたはサーバーへの接続要求が失敗した。
DPNERR_TIMEDOUT
時間切れのため、操作が完了できなかった。
DPNERR_UNINITIALIZED
要求されたオブジェクトが初期化されていない。
DPNERR_UNSUPPORTED
関数または機能を、この実装やこのサービス プロバイダで使用できない。
DPNERR_USERCANCEL
ユーザーは処理を取り消した。
DV_OK
要求は正常に終了した。
DV_FULLDUPLEX
サウンド カードは全二重操作が可能である。
DV_HALFDUPLEX
サウンド カードは半二重モードでしか動作しない。
DVERR_BUFFERTOOSMALL
指定されたバッファが、要求されたデータを格納するのに十分な大きさでない。
DVERR_EXCEPTION
要求処理時に例外が発生した。
DVERR_GENERIC
未定義エラー条件が発生した。
DVERR_INVALIDFLAGS
このメソッドに渡されたフラグが無効であった。
DVERR_INVALIDOBJECT
DirectPlay オブジェクト ポインタが無効である。
DVERR_INVALIDPARAM
メソッドに渡されたパラメータのいずれかまたはいくつかが無効である。
DVERR_INVALIDPLAYER
プレーヤー ID がこのゲーム セッションの有効なプレーヤー ID として認識されない。
DVERR_INVALIDGROUP
グループ ID が、このゲーム セッションの有効なグループ ID として認識されない。
DVERR_INVALIDHANDLE
指定されたハンドルは無効である。
DVERR_OUTOFMEMORY
要求された操作を実行するには、メモリが不足している。
DVERR_PENDING
エラーではない。この戻り値は、非同期処理で、キューへの設定が成功するところまで処理が進んだことを示す。
DVERR_NOTSUPPORTED
操作がサポートされていない。
DVERR_NOINTERFACE
指定されたインターフェイスがサポートされていない。使用した DirectPlay のバージョンが間違っている可能性がある。
DVERR_SESSIONLOST
トランスポートはセッションへの接続を喪失した。
DVERR_NOVOICESESSION
指定されたセッションは音声セッションではない。
DVERR_CONNECTIONLOST
音声セッションへの接続が喪失した。
DVERR_NOTINITIALIZED
このメソッドを呼び出す前に、IDirectPlayVoiceClient::Initialize メソッドまたは IDirectPlayVoiceServer::Initialize メソッドを呼び出す必要がある。
DVERR_CONNECTED
DirectPlayVoice オブジェクトが接続されている。
DVERR_NOTCONNECTED
DirectPlayVoice オブジェクトが接続されていない。
DVERR_CONNECTABORTING
接続解除中。
DVERR_NOTALLOWED
オブジェクトには、この操作を実行する権限がない。
DVERR_INVALIDTARGET
指定されたターゲットは、この音声セッションの有効なプレーヤー ID またはグループ ID ではない。
DVERR_TRANSPORTNOTHOST
オブジェクトは音声セッションのホストではない。
DVERR_COMPRESSIONNOTSUPPORTED
指定された圧縮タイプがローカル コンピュータでサポートされていない。
DVERR_ALREADYPENDING
このタイプの非同期呼び出しが既にペンディング状態になっている。
DVERR_ALREADYINITIALIZED
オブジェクトは既に初期化されている。
DVERR_SOUNDINITFAILURE
サウンド カードの初期化に失敗した。
DVERR_TIMEOUT
指定された時間内に操作を実行できなかった。
DVERR_CONNECTABORTED
接続は、完了前に取り消された。
DVERR_NO3DSOUND
ローカル コンピュータでは 3D サウンドをサポートしていない。
DVERR_ALREADYBUFFERED
指定された ID には既にユーザー バッファがある。
DVERR_NOTBUFFERED
指定された ID にはユーザー バッファがない。
DVERR_HOSTING
オブジェクトはセッションのホストである。
DVERR_NOTHOSTING
オブジェクトはセッションのホストではない。
DVERR_INVALIDDEVICE
指定されたデバイスが無効である。
DVERR_RECORDSYSTEMERROR
録音システムにエラーが発生した。
DVERR_PLAYBACKSYSTEMERROR
再生システムにエラーが発生した。
DVERR_SENDERROR
データの送信中にエラーが発生した。
DVERR_USERCANCEL
ユーザーは処理を取り消した。
DVERR_UNKNOWN
不明なエラーが発生した。
DVERR_RUNSETUP
指定されたオーディオ構成はテストされていない。IDirectPlayVoiceTest::CheckAudioSetup メソッドを呼び出す。
DVERR_INCOMPATIBLEVERSION
クライアントは、ホストと互換性がない音声セッションに接続した。
DVERR_INITIALIZED
オブジェクトがすでに初期化されているため、Initialize メソッドが失敗した。
DVERR_INVALIDPOINTER
指定されたポインタが無効である。
DVERR_NOTRANSPORT
指定されたオブジェクトは有効なトランスポートではない。
DVERR_NOCALLBACK
コールバック関数が指定されていないため、この操作は実行できない。
DVERR_TRANSPORTNOTINIT
指定されたトランスポートはまだ初期化されていない。
DVERR_TRANSPORTNOSESSION
指定されたトランスポートは有効だが、接続されてないかホストしていない。
DVERR_TRANSPORTNOPLAYER
指定されたトランスポートは接続され、ホストしているが、ローカル プレーヤーが存在しない。