DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO 콜백 함수(d3dkmddi.h)
pfnAcquireFirstPathInfo 구조체는 지정된 VidPN 토폴로지 개체에서 첫 번째 경로의 설명자를 반환합니다.
통사론
DXGKDDI_VIDPNTOPOLOGY_ACQUIREFIRSTPATHINFO DxgkddiVidpntopologyAcquirefirstpathinfo;
NTSTATUS DxgkddiVidpntopologyAcquirefirstpathinfo(
[in] IN_CONST_D3DKMDT_HVIDPNTOPOLOGY hVidPnTopology,
[out] DEREF_OUT_CONST_PPD3DKMDT_VIDPN_PRESENT_PATH ppFirstVidPnPresentPathInfo
)
{...}
매개 변수
[in] hVidPnTopology
VidPN 토폴로지 개체에 대한 핸들입니다. 디스플레이 미니포트 드라이버는 이전에 DXGK_VIDPN_INTERFACE 인터페이스의 pfnGetTopology 함수를 호출하여 이 핸들을 얻었습니다.
[out] ppFirstVidPnPresentPathInfo
D3DKMDT_VIDPN_PRESENT_PATH 구조체에 대한 포인터를 받는 변수에 대한 포인터입니다. 구조체에는 경로의 원본 및 대상 식별자를 포함하여 경로에 대한 다양한 정보가 포함됩니다.
반환 값
pfnAcquireFirstPathInfo 함수는 다음 값 중 하나를 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
| STATUS_SUCCESS | 함수가 성공했습니다. |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | hVidPnTopology에 제공된 핸들이 잘못되었습니다. |
발언
D3DKMDT_VIDPN_PRESENT_PATH 구조체 사용을 마쳤으면 pfnReleasePathInfo호출하여 구조를 해제해야 합니다.
pfnAcquireFirstPathInfo 호출한 다음, pfnAcquireNextPathInfo 호출 시퀀스를 만들어 VidPN 토폴로지 개체에 속하는 모든 경로를 열거할 수 있습니다.
D3DKMDT_HVIDPNTOPOLOGY 데이터 형식은 D3dkmdt.h정의됩니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | d3dkmddi.h(D3dkmddi.h 포함) |
| IRQL | PASSIVE_LEVEL |