戻り値
エラーは負の値で表され、それらを組み合わせることはできない。
次の表は、以降で示すエラー値が適用されるインターフェイスのリストである。
各メソッドにより返されるエラー値については、個別のメソッドの説明を参照すること。
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
- 指定されたトランスポートは接続され、ホストしているが、ローカル プレーヤーが存在しない。