KsOpenDefaultDevice 함수(ksproxy.h)

KsOpenDefaultDevice 함수는 지정된 PnP(플러그 앤 플레이) 범주에 나열된 첫 번째 디바이스에 대한 핸들을 엽니다.

구문

KSDDKAPI HRESULT KsOpenDefaultDevice(
  [in]  REFGUID     Category,
  [in]  ACCESS_MASK Access,
  [out] PHANDLE     DeviceHandle
);

매개 변수

[in] Category

열거할 PnP 범주의 식별자입니다.

[in] Access

기본 디바이스에 액세스하는 방법을 지정하는 ACCESS_MASK 비트 마스크입니다.

[out] DeviceHandle

열려 있는 기본 디바이스에 대한 핸들을 수신하는 변수에 대한 포인터입니다.

반환 값

성공하면 NOERROR를 반환합니다. 그렇지 않으면 오류 코드를 반환합니다.

설명

KsOpenDefaultDevice 함수는 SetupDiGetClassDevs 함수에 대한 호출에서 범주에 대한 포인터를 전달하여 PnP 디바이스 목록에 대한 핸들을 가져옵니다. ACCESS_MASK 비트 마스크 및 SetupDiGetClassDevs에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.

요구 사항

   
대상 플랫폼 데스크톱
헤더 ksproxy.h(Ksproxy.h 포함)
라이브러리 Ksproxy.lib