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)

D3D11_1DDIARG_CREATEAUTHENTICATEDCHANNEL

NegotiateAuthenticatedChannelKeyExchange