PFND3DDDI_RENAME 콜백 함수(d3dumddi.h)
Rename 함수는 사용자 모드 표시 드라이버에 LockAsync 함수가 이전에 지정된 리소스에 대해 반환한 이름이 바뀐 할당 사용을 시작하도록 알립니다.
구문
PFND3DDDI_RENAME Pfnd3dddiRename;
HRESULT Pfnd3dddiRename(
HANDLE hDevice,
const D3DDDIARG_RENAME *unnamedParam2
)
{...}
매개 변수
hDevice
디스플레이 디바이스(즉, 그래픽 컨텍스트)에 대한 핸들입니다.
unnamedParam2
pData [in]
새 할당을 사용하여 이름을 바꿀 리소스 또는 리소스 내의 표면을 설명하는 D3DDDIARG_RENAME 구조체에 대한 포인터입니다.
반환 값
이름 바꾸기 는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| S_OK | 리소스 이름이 성공적으로 변경되었습니다. |
| E_OUTOFMEMORY | 이름 바꾸기를 완료하는 데 필요한 메모리를 할당할 수 없습니다. |
설명
다중 프로세서 컴퓨터에서 Microsoft Direct3D 런타임은 기본 애플리케이션 스레드가 아닌 작업자 스레드에서 사용자 모드 디스플레이 드라이버의 Rename 함수를 호출합니다. 런타임은 LockAsync의 pData 매개 변수가 가리키는 D3DDDIARG_LOCKASYNC 구조체의 Flags 멤버에 설정된 삭제 비트 필드 플래그를 사용하여 드라이버의 LockAsync 함수를 성공적으로 호출할 때마다 한 번씩 Rename를 호출합니다.
이름 바꾸기는 이름 바꾸기의 pData 매개 변수가 가리키는D3DDDIARG_RENAME 구조체의 hCookie 멤버에 의해 지정된 이름이 바뀐 할당 사용을 시작하도록 드라이버에 알립니다. 잠긴 리소스에 대해 삭제 비트 필드 플래그가 설정된 경우 이전에 LockAsync 함수에서 hCookie 핸들을 반환했습니다.
이름 바꾸기가 성공적으로 반환되면(S_OK 사용) 사용자 모드 표시 드라이버는 hCookie가 D3DDDIARG_RENAME hResource 및 SubResourceIndex 멤버가 지정하는 리소스를 참조하는 모든 렌더링 작업에 대해 지정하는 할당을 사용해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | d3dumddi.h(D3dumddi.h 포함) |