Méthode IStiDeviceControl ::GetMyDevicePortName (stiusd.h)

La méthode IStiDeviceControl ::GetMyDevicePortName permet à un minidriver d’image fixe en mode utilisateur d’obtenir le nom de port d’un appareil.

Syntaxe

HRESULT GetMyDevicePortName(
  LPWSTR lpszDevicePath,
  DWORD  cwDevicePathSize
);

Paramètres

lpszDevicePath

Pointeur fourni par l’appelant vers une mémoire tampon pour recevoir le nom de port de l’appareil.

cwDevicePathSize

Nombre de caractères fournis par l’appelant (de type TCHAR) dans la mémoire tampon pointée par lpszDevicePath.

Valeur retournée

Si l’opération réussit, la méthode retourne S_OK. Sinon, il retourne l’un des codes d’erreur préfixés STIERR définis dans stierr.h.

Remarques

Le nom de chemin qu’un minidriver d’image fixe reçoit en appelant IStiDeviceControl ::GetMyDevicePortName peut être utilisé comme argument d’entrée dans CreateFile (décrit dans la documentation Microsoft Windows SDK).

Un minidriver d’image fixe reçoit un pointeur d’interface IStiDeviceControl comme argument d’entrée à sa méthode IStiUSD ::Initialize .

Configuration requise