nf-ksproxy-ksopendefaultdevice.md

UID	title	description	old-location	tech.root	ms.date	keywords	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	f1_keywords	topic_type	api_type	api_location	api_name
NF:ksproxy.KsOpenDefaultDevice	KsOpenDefaultDevice function (ksproxy.h)	The KsOpenDefaultDevice function opens a handle to the first device that is listed in the specified Plug and Play (PnP) category.	stream\ksopendefaultdevice.htm	stream	04/23/2018	KsOpenDefaultDevice function	KsOpenDefaultDevice, KsOpenDefaultDevice function [Streaming Media Devices], ksproxy/KsOpenDefaultDevice, ksproxy_9c80d462-baaa-497b-a337-5d42e94b9c3f.xml, stream.ksopendefaultdevice	ksproxy.h	Ksproxy.h	Desktop												Ksproxy.lib			Windows		KsOpenDefaultDevice ksproxy/KsOpenDefaultDevice	APIRef kbSyntax	LibDef	Ksproxy.lib Ksproxy.dll	KsOpenDefaultDevice

KsOpenDefaultDevice function

-description

The KsOpenDefaultDevice function opens a handle to the first device that is listed in the specified Plug and Play (PnP) category.

-parameters

-param Category [in]

Identifier of the PnP category to enumerate.

-param Access [in]

An ACCESS_MASK bitmask specifying how to access the default device.

-param DeviceHandle [out]

Pointer to a variable that receives the handle to the default device that is opened.

-returns

Returns NOERROR if successful; otherwise, returns an error code.

-remarks

The KsOpenDefaultDevice function passes a pointer to Category in a call to the SetupDiGetClassDevs function to obtain a handle to the list of PnP devices. For more information about the ACCESS_MASK bitmask and SetupDiGetClassDevs, see the Microsoft Windows SDK documentation.