DXGKDDI_VIDPNTOPOLOGY_ADDPATH 콜백 함수(d3dkmddi.h)
pfnAddPath 함수는 지정된 VidPN 토폴로지 개체에 비디오 현재 경로를 추가합니다.
구문
DXGKDDI_VIDPNTOPOLOGY_ADDPATH DxgkddiVidpntopologyAddpath;
NTSTATUS DxgkddiVidpntopologyAddpath(
[in] IN_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[in] IN_PD3DKMDT_VIDPN_PRESENT_PATH pVidPnPresentPath
)
{...}
매개 변수
[in] hVidPnTopology
VidPN 토폴로지 개체에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DXGK_VIDPN_INTERFACE 인터페이스의 pfnGetTopology 함수를 호출하여 이 핸들을 얻었습니다.
[in] pVidPnPresentPath
경로를 설명하는 D3DKMDT_VIDPN_PRESENT_PATH 구조체에 대한 포인터입니다. 디스플레이 미니포트 드라이버는 이전에 pfnCreateNewPathInfo를 호출하여 이 포인터를 얻었습니다.
반환 값
pfnAddPath 함수는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_SUCCESS | 함수가 성공했습니다. |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | hVidPnTopology에 제공된 핸들이 잘못되었습니다. |
| STATUS_ACCESS_DENIED | 경로는 현재 DDI 호출의 컨텍스트에서 제거할 수 없습니다. |
설명
토폴로지 경로를 추가하려면 디스플레이 미니포트 드라이버가 다음 단계를 수행합니다.
pfnCreateNewPathInfo를 호출하여 VidPN 관리자가 할당한 D3DKMDT_VIDPN_PRESENT_PATH 구조체에 대한 포인터를 가져옵니다.
비디오 현재 원본 및 대상 식별자를 포함하여 경로에 대한 정보로 D3DKMDT_VIDPN_PRESENT_PATH 구조를 채웁다.
pfnAddPath를 호출하여 토폴로지 경로를 추가합니다.
VidPN 관리자는 pfnCreateNewPathInfo를 호출할 때 D3DKMDT_VIDPN_PRESENT_PATH 구조를 할당합니다. 해당 구조체에서 설명하는 경로를 토폴로지에 추가하는 경우 구조를 명시적으로 해제할 필요가 없습니다. pfnAddPath 가 릴리스합니다.
pfnCreateNewPathInfo를 호출하여 D3DKMDT_VIDPN_PRESENT_PATH 구조를 가져온 다음 토폴로지에 해당 경로를 추가하지 않기로 결정한 경우 pfnReleasePathInfo를 호출하여 구조체를 명시적으로 해제해야 합니다.
D3DKMDT_HVIDPNTOPOLOGY 데이터 형식은 D3dkmdt.h에 정의되어 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | d3dkmddi.h(D3dkmddi.h 포함) |
| IRQL | PASSIVE_LEVEL |