IDirect3DTexture9::GetPrivateData 메서드

리소스에 관련된 Private 데이터가 제공된 버퍼에 복사 한다.

구문

HRESULT GetPrivateData(      

    REFGUID refguid,
    void *pData,
    DWORD *pSizeOfData
);

파라미터

refguid
[in] 얻어온다 Private 데이터를 식별하는 글로벌 일의 식별자에의 참조 (C++) 또는 주소 (C).
pData
[in, out] 호출이 성공했을 경우에, 요구한 Private 데이터를 저장 하는 할당이 끝난 버퍼의 포인터. 이 메서드를 호출하는 애플리케이션은, 이 버퍼의 할당과 릴리즈에 책임을 진다. 이 파라미터가 NULL 의 경우, 이 메서드는 pSizeOfData 에 버퍼 사이즈를 돌려준다.
pSizeOfData
[in, out] pData 의 버퍼 사이즈 (바이트 단위)의 포인터. 이 값이 실제의 Private 데이터의 사이즈보다 작은 (0 등) 경우, 메서드는 이 파라미터가 요구되는 버퍼 사이즈로 설정해,D3DERR_MOREDATA 를 돌려준다.

반환값

성공했을 경우는,D3D_OK 를 돌려준다.
실패했을 경우는, 다음의 몇개의 값을 돌려준다.
D3DERR_INVALIDCALL 메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.
D3DERR_MOREDATA 지정된 버퍼 사이즈 로 유지할 수 있는 이상의 데이터가 존재한다.
D3DERR_NOTFOUND 요구된 항목이 발견되지 않았다.

주의

이 메서드는, 다음의 인터페이스에 의해 계승된다. IDirect3DResource9 ,IDirect3DBaseTexture9 ,IDirect3DCubeTexture9 ,IDirect3DTexture9 ,IDirect3DVolumeTexture9 ,IDirect3DIndexBuffer9 ,IDirect3DVertexBuffer9

D3DERR_INVALIDCALL	메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.
D3DERR_MOREDATA	지정된 버퍼 사이즈 로 유지할 수 있는 이상의 데이터가 존재한다.
D3DERR_NOTFOUND	요구된 항목이 발견되지 않았다.