PFND3DDDI_GETPITCH 콜백 함수(d3dumddi.h)
GetPitch 함수는 보호되거나 잠글 수 없는 표면의 피치를 검색합니다.
구문
PFND3DDDI_GETPITCH Pfnd3dddiGetpitch;
HRESULT Pfnd3dddiGetpitch(
HANDLE hDevice,
D3DDDIARG_GETPITCH *unnamedParam2
)
{...}
매개 변수
hDevice
디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다.
unnamedParam2
pData [in, out]
보호된 표면을 설명하는 D3DDDIARG_GETPITCH 구조체에 대한 포인터입니다.
반환 값
GetPitch 함수는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| S_OK | 보호된 표면의 피치가 성공적으로 검색됩니다. |
| D3DDDIERR_NOTAVAILABLE | 드라이버는 GetPitch 함수를 지원하지 않습니다. |
설명
하드웨어 및 드라이버는 필요에 따라 GetPitch 함수를 지원할 수 있습니다.
GetPitch 함수가 피치를 반환하는 표면은 잠금이 불가능하거나 보호될 수 있습니다. 따라서 애플리케이션은 드라이버의 Lock 함수 호출을 통해 표면의 피치를 검색할 수 없습니다. 애플리케이션은 드라이버의 EncryptionBlt 및 DecryptionBlt 함수 호출에서 애플리케이션이 이후에 사용하는 시스템 메모리 버퍼를 제대로 할당하기 위해 표면의 피치를 검색해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | GetPitch는 Windows 7 운영 체제부터 지원됩니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dumddi.h(D3dumddi.h 포함) |