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