PFND3DDDI_CREATEAUTHENTICATEDCHANNEL 콜백 함수(d3dumddi.h)
CreateAuthenticatedChannel 함수는 Microsoft Direct3D 런타임과 드라이버가 보호를 설정하고 쿼리하는 데 사용할 수 있는 채널을 만듭니다.
구문
PFND3DDDI_CREATEAUTHENTICATEDCHANNEL Pfnd3dddiCreateauthenticatedchannel;
HRESULT Pfnd3dddiCreateauthenticatedchannel(
HANDLE hDevice,
D3DDDIARG_CREATEAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
매개 변수
hDevice
디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다.
unnamedParam2
pData [in, out]
D3DDDIARG_CREATEAUTHENTICATEDCHANNEL 구조체에 대한 포인터입니다. 입력에서 이 구조체에는 드라이버에서 사용할 수 있는 정보가 포함됩니다. 출력 시 드라이버는 Direct3D 런타임에서 사용할 수 있는 구조의 정보를 지정합니다.
반환 값
CreateAuthenticatedChannel은 다음 값 중 하나를 반환합니다.
반환 코드 | 설명 |
---|---|
S_OK | 채널이 성공적으로 생성되었습니다. |
E_OUTOFMEMORY | CreateAuthenticatedChannel 에서 완료하는 데 필요한 메모리를 할당할 수 없습니다. |
D3DDDIERR_NOTAVAILABLE | 드라이버는 pData 매개 변수가 가리키는 D3DDDIARG_CREATEAUTHENTICATEDCHANNEL 구조체의 ChannelType 멤버에 지정된 채널 형식을 지원하지 않습니다. |
설명
런타임은 핸들이 필요한 모든 후속 호출에서 드라이버가 D3DDDIARG_CREATEAUTHENTICATEDCHANNEL 구조의 ChannelType 멤버에서 반환하는 인증된 채널에 핸들을 전달합니다.
드라이버는 인증된 채널을 만드는 데 사용된 디스플레이 디바이스(hDevice)를 추적해야 합니다. 해당 호출에 지정된 표시 디바이스가 인증된 채널을 만드는 데 사용된 디스플레이 디바이스와 다른 경우 드라이버는 이 만든 인증 채널(예: AuthenticatedChannelKeyExchange 함수)을 사용하는 모든 후속 호출에 실패해야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | CreateAuthenticatedChannel은 Windows 7 운영 체제부터 지원됩니다. |
대상 플랫폼 | 데스크톱 |
머리글 | d3dumddi.h(D3dumddi.h 포함) |