SDGetDeviceHandle (Compact 2013)

3/26/2014

This function retrieves a secure digital (SD) device handle derived from the initialization context passed in to the XXX_Init (Device Manager) entry point of a client driver. The real registry path of the client device driver can optionally be returned.

Syntax

SD_DEVICE_HANDLE SDGetDeviceHandle(
  DWORD InitContext,
  PWCHAR* ppRegPath
);

Parameters

• InitContext
  [in] Device context passed into the XXX_Init entry point of a client device driver.

• ppRegPath
  [out] Optional. The registry path of the client device driver.

Return Value

On success, returns a handle to an SD device of type SD_DEVICE_HANDLE. Returns NULL on failure.

Remarks

If ppRegPathis NULL, the registry path will not be returned. This function then allocates storage for the registry path, and it becomes the responsibility of the client driver to free this memory through a call to XXX_Deinit (Device Manager).

Requirements

See Also

Reference

Secure Digital (SD) Card Driver Functions
XXX_Init (Device Manager)
XXX_Deinit (Device Manager)