PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL 콜백 함수(d3dumddi.h)
ConfigureAuthenticatedChannel 함수는 인증된 채널 내에서 상태를 설정합니다.
구문
PFND3DDDI_CONFIGUREAUTHENICATEDCHANNEL Pfnd3dddiConfigureauthenicatedchannel;
HRESULT Pfnd3dddiConfigureauthenicatedchannel(
HANDLE hDevice,
const D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL *unnamedParam2
)
{...}
매개 변수
hDevice
디스플레이 디바이스(그래픽 컨텍스트)에 대한 핸들입니다.
unnamedParam2
pData [in, out]
인증된 채널을 구성하는 방법을 설명하는 D3DDDIARG_CONFIGUREAUTHENTICATEDCHANNEL 구조체에 대한 포인터입니다. 이 구조에는 인증된 채널을 구성하는 방법을 설명하는 입력 버퍼와 구성 정보가 포함된 출력 버퍼가 포함되어 있습니다.
반환 값
ConfigureAuthenticatedChannel은 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| S_OK | 인증된 채널이 성공적으로 구성되었습니다. |
| E_OUTOFMEMORY | ConfigureAuthenticatedChannel 에서 완료하는 데 필요한 메모리를 할당할 수 없습니다. |
설명
입력 버퍼에는 드라이버가 인증해야 하는 CBC(One-key Cipher Block Chaining) 모드 OMAC(메시지 인증 코드)가 포함되어 있습니다. 입력 버퍼에는 인증된 채널에 대한 드라이버 핸들, 시퀀스 번호 및 구성 유형을 나타내는 GUID도 포함됩니다.
입력 OMAC가 일치하지 않거나, 시퀀스 번호가 이전 호출에서 지정한 시퀀스 번호보다 크지 않거나, 시퀀스 번호가 아직 초기화되지 않은 경우(이 마지막 규칙에 대한 예외는 초기화 호출 자체에 대한 예외임) 드라이버가 ConfigureAuthenticatedChannel 에 실패해야 합니다.
드라이버는 출력 버퍼의 구조에서 입력 데이터를 복제해야 하며 현재 OPM( 출력 보호 관리자 ) 쿼리를 처리하는 방법과 동일한 방식으로 출력 구조에 서명해야 합니다.
애플리케이션이 너무 작은 출력 버퍼를 잘못 지정하는 경우를 제외하고 드라이버는 항상 반환 코드를 출력 구조에 배치해야 합니다. 따라서 애플리케이션에는 반환 코드를 결정하는 보안 메커니즘이 있습니다.
ConfigureAuthenticatedChannel 은 입력 구조에 지정된 다음 GUID 각각에 따라 다른 작업을 수행합니다. 입력 버퍼 크기가 지정된 GUID에 대해 정의된 크기와 일치하지 않으면 드라이버가 실패해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | ConfigureAuthenticatedChannel은 Windows 7 운영 체제부터 지원됩니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dumddi.h(D3dumddi.h 포함) |