Microsoft DirectX 8.0 (C++) |
バッファ内のサウンド データのフォーマットに関する情報、またはフォーマットの記述を取得するのに必要なバッファ サイズを取得する。
HRESULT GetFormat( LPWAVEFORMATEX pwfxFormat, DWORD dwSizeAllocated, LPDWORD pdwSizeWritten );
成功した場合は DS_OK を返す。
失敗した場合は DSERR_INVALIDPARAM を返す。
WAVEFORMATEX 構造体は、フォーマットに応じた可変長であってもよい。アプリケーションはフォーマットの記述を取得する前に、pwfxFormat パラメータに NULL を指定してこのメソッドを呼び出し、フォーマットのサイズに関して DirectSoundBuffer オブジェクトを照会する必要がある。必要な構造体のサイズは pdwSizeWritten パラメータへ返される。その後、アプリケーションは十分なメモリを割り当て、もう一度 IDirectSoundBuffer8::GetFormat を呼び出し、フォーマットの記述を取得できる。
ヘッダー : dsound.h で宣言。