PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL 콜백 함수(d3d10umddi.h)
인증된 채널 개체를 만듭니다. WDDM(Windows 디스플레이 드라이버 모델) 1.2 이상 사용자 모드 디스플레이 드라이버에 의해 구현됩니다.
구문
PFND3D11_1DDI_CREATEAUTHENTICATEDCHANNEL Pfnd3d111DdiCreateauthenticatedchannel;
HRESULT Pfnd3d111DdiCreateauthenticatedchannel(
D3D10DDI_HDEVICE hDevice,
D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL *pCreateData,
D3D11_1DDI_HAUTHCHANNEL hAuthChannel,
D3D11_1DDI_HRTAUTHCHANNEL hRTAuthChannel
)
{...}
매개 변수
hDevice
디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다.
pCreateData
D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL 구조체에 대한 포인터입니다. 이 구조체는 만들 인증된 채널의 특성을 지정합니다.
hAuthChannel
인증된 채널 개체에 대한 드라이버의 개인 데이터에 대한 핸들입니다. 자세한 내용은 주의 섹션을 참조하세요.
hRTAuthChannel
드라이버가 Direct3D 런타임으로 다시 호출할 때 사용해야 하는 인증된 채널 개체에 대한 핸들입니다.
반환 값
다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| S_OK | 인증된 채널이 성공적으로 만들어졌습니다. |
| D3DDDIERR_DEVICEREMOVED | 그래픽 어댑터가 제거되었습니다. |
| E_OUTOFMEMORY | 메모리를 사용하여 작업을 완료할 수 없습니다. |
설명
Direct3D 런타임은 드라이버의 CalcPrivateAuthenticatedChannelSize를 호출한 후 CreateAuthenticatedChannel(D3D11_1)을 호출하여 드라이버가 인증된 채널 개체에 필요한 프라이빗 데이터의 크기(바이트)를 결정합니다. 런타임은 드라이버에 대해 이 프라이빗 데이터에 대한 메모리를 할당합니다. 드라이버는 이 메모리를 사용하여 인증 채널 개체와 관련된 개인 데이터를 저장합니다.
런타임이 CreateAuthenticatedChannel(D3D11_1)을 호출하면 hAuthChannel 매개 변수의 프라이빗 데이터 메모리에 핸들을 전달합니다. 이 핸들은 실제로 메모리에 대한 포인터입니다.
드라이버는 인증된 채널을 만드는 데 사용된 디스플레이 디바이스에 대한 핸들을 추적해야 합니다. 이 호출에 지정된 디스플레이 디바이스가 인증된 채널을 만드는 데 사용된 디스플레이 디바이스와 다른 경우 드라이버는 NegotiateAuthenticatedChannelKeyExchange와 같이 이 생성된 인증 채널을 사용하는 모든 후속 호출에 실패해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 |
| 지원되는 최소 서버 | Windows Server 2012 |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3d10umddi.h(D3d10umddi.h 포함) |
추가 정보
CalcPrivateAuthenticatedChannelSize
CreateAuthenticatedChannel(D3D11_1)