Méthode IVdsSubSystem::CreateLun (vdshwprv.h)
[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API Gestion du stockage Windows.]
La méthode CreateLun crée un numéro d’unité logique (LUN).
Syntaxe
HRESULT CreateLun(
[in] VDS_LUN_TYPE type,
[in] ULONGLONG ullSizeInBytes,
[in] VDS_OBJECT_ID *pDriveIdArray,
[in] LONG lNumberOfDrives,
[in] LPWSTR pwszUnmaskingList,
[in] VDS_HINTS *pHints,
[out] IVdsAsync **ppAsync
);
Paramètres
[in] type
Valeur d’énumération VDS_LUN_TYPE qui spécifie le type de LUN. Le nouveau LUN peut être un type automagic ou un type RAID spécifique, mais pas les deux. Si l’appelant spécifie un type automagic, un ou plusieurs indicateurs automagiques doivent être spécifiés dans le paramètre pHints .
Le pointeur d’interface pour le nouvel objet LUN peut être récupéré en appelant la méthode IVdsAsync::Wait sur le pointeur d’interface retourné dans le paramètre ppAsync . La structure VDS_ASYNC_OUTPUT retournée par Wait contient le pointeur d’interface d’objet LUN dans le membre cl.pLunUnk .
[in] ullSizeInBytes
Taille, en octets, de la nouvelle LUN. Le fournisseur peut arrondir la taille vers le haut ou vers le bas pour répondre aux exigences d’alignement ou à d’autres restrictions. (Dans la plupart des cas, le fournisseur arrondit, en veillant à ce que, à de rares exceptions près, le LUN soit au moins aussi volumineux que demandé.)
Une fois la LUN créée, l’appelant peut déterminer la taille réelle de la LUN en appelant la méthode IVdsLun::GetProperties .
[in] pDriveIdArray
Pointeur vers un tableau qui contient un VDS_OBJECT_ID pour chacun des lecteurs à utiliser pour créer la LUN. En spécifiant une valeur non NULL pour ce paramètre, l’appelant demande au fournisseur d’utiliser tous les lecteurs, dans l’ordre fourni, en utilisant toutes les étendues sur un lecteur avant de passer à l’autre et de s’arrêter lorsque la LUN a atteint la taille demandée.
L’appelant peut également demander au fournisseur de sélectionner automatiquement les lecteurs en passant NULL dans ce paramètre et 0 dans lNumberOfDrives. (Passez la valeur NULL si et uniquement si lNumberOfDrives a la valeur 0.)
Si le paramètre de type spécifie un type automagic, ce paramètre doit avoir la valeur NULL.
[in] lNumberOfDrives
Nombre de lecteurs spécifiés dans pDriveIdArray. Si l’appelant passe 0, le fournisseur sélectionne les lecteurs.
Si le paramètre type spécifie un type automagic, ce paramètre doit être 0.
Une fois la LUN créée, l’appelant peut déterminer les lecteurs en cours d’utilisation en appelant la méthode IVdsLunPlex::QueryExtents .
[in] pwszUnmaskingList
Liste spécifiant les ordinateurs à accorder l’accès au LUN. La liste est une chaîne délimitée par des points-virgules, terminée par NULL et lisible par l’homme.
Si la valeur est « », tous les ordinateurs qui ont un port HBA attaché au sous-système de stockage doivent avoir accès à la LUN. Si la valeur est « », aucun ordinateur ne doit avoir accès à la LUN.
Si « * » ou « » est spécifié, aucune autre valeur ne peut être spécifiée.
Pour les réseaux Fibre Channel et les réseaux SCSI (SAS) attachés en série, chaque entrée est un nom mondial (WWN) 64 bits de chaque port auquel la LUN est démasquée, mis en forme sous forme de chaîne hexadécimale (16 caractères de long), octet le plus significatif en premier. Par exemple, une adresse WWN de 01:23:45:67:89:AB:CD:EF est représentée sous la forme « 0123456789ABCDEF ». Pour plus d’informations, consultez les spécifications T10 pour Fibre Channel et SAS.
Pour les réseaux iSCSI, chaque entrée est un nom qualifié iSCSI (IQN) de chaque initiateur auquel le LUN est masqué. Un LUN démasqué à un initiateur particulier est considéré comme associé à cet initiateur.
[in] pHints
Pointeur vers une structure VDS_HINTS qui spécifie les indicateurs à utiliser lors de la création de la LUN. Le fournisseur n’est pas obligé d’appliquer les indicateurs au LUN. Les indicateurs spécifiés dans la structure VDS_HINTS sont uniquement une requête adressée au fournisseur.
Une fois la LUN créée, l’appelant peut déterminer les indicateurs que le fournisseur a appliqués en appelant la méthode IVdsLun::QueryHints ou la méthode IVdsLunPlex::QueryHints .
Si le paramètre de type spécifie un type non automagique, ce paramètre doit avoir la valeur NULL.
[out] ppAsync
Adresse d’un pointeur d’interface IVdsAsync , que VDS initialise au retour. Les appelants doivent libérer l’interface. Utilisez cette interface pour annuler, attendre ou interroger l’état de l’opération.
Si IVdsAsync::Wait est appelé sur le pointeur d’interface retourné et qu’une valeur HRESULT de réussite est retournée, les interfaces retournées dans la structure VDS_ASYNC_OUTPUT doivent être libérées en appelant la méthode IUnknown::Release sur chaque pointeur d’interface. Toutefois, si Wait retourne une valeur HRESULT d’échec ou si le paramètre pHrResult de Wait reçoit une valeur HRESULT d’échec, les pointeurs d’interface dans la structure VDS_ASYNC_OUTPUT sont NULL et n’ont pas besoin d’être libérés. Vous pouvez tester la réussite ou l’échec des valeurs HRESULT à l’aide des macros SUCCEEDED et FAILED définies dans Winerror.h.
Valeur retournée
Cette méthode peut retourner des valeurs HRESULT standard, telles que E_INVALIDARG ou E_OUTOFMEMORY, et des valeurs de retour spécifiques à VDS. Il peut également retourner des codes d’erreur système convertis à l’aide de la macro HRESULT_FROM_WIN32 . Les erreurs peuvent provenir de VDS lui-même ou du fournisseur VDS sous-jacent utilisé. Les valeurs de retour possibles sont les suivantes.
| Code/valeur de retour | Description |
|---|---|
|
Cette valeur de retour signale un problème logiciel ou de communication à l’intérieur d’un fournisseur qui met en cache des informations sur le tableau. Utilisez la méthode IVdsHwProvider::Reenumerate suivie de la méthode IVdsHwProvider::Refresh pour restaurer le cache. |
|
L’objet de sous-système n’est plus présent. |
|
Le sous-système est dans un état d’échec et n’est pas en mesure d’effectuer l’opération demandée. |
|
Une autre opération est en cours ; cette opération ne peut pas se poursuivre tant que la ou les opérations précédentes ne sont pas terminées. |
|
Peut être retourné à partir de n’importe quelle méthode qui prend une constante VDS_OBJECT_ID . Cette valeur de retour indique que l’identificateur ne fait pas référence à un objet existant. |
|
Cette opération ou cette combinaison de paramètres n’est pas prise en charge par ce fournisseur. |
|
Il n’y a pas assez d’espace utilisable pour cette opération. |
|
Trop peu de lecteurs libres sont présents dans le sous-système pour effectuer cette opération. |
Remarques
En choisissant les valeurs appropriées pour les paramètres type et pHints , l’appelant peut spécifier les attributs du LUN entièrement, partiellement ou au minimum. Le fournisseur peut inclure automatiquement des attributs non spécifiés, en fonction des indicateurs automagiques spécifiés dans la structure VDS_HINTS vers laquelle pointe le paramètre pHints .
Si le fournisseur VDS prend uniquement en charge des configurations cibles simples, le sous-système doit associer automatiquement l’objet LUN nouvellement créé à un objet cible iSCSI. Consultez la valeur VDS_SF_SUPPORTS_SIMPLE_TARGET_CONFIG de l’énumération VDS_SUB_SYSTEM_FLAG .
La liste des noms WWN et IQN dans le paramètre pwszUnmaskingList peut contenir des noms en double. Il incombe au fournisseur de valider tous les noms de la liste et de supprimer les doublons si nécessaire.
Le fournisseur de matériel est responsable de la suppression des informations de partition de la LUN afin que celle-ci puisse être réutilisée. Si le LUN est un disque MBR, cela s’effectue en écrivant des zéros sur le premier et le dernier Mo du disque. Pour un disque GPT, les zéros doivent être écrits dans le premier et le dernier 16 Ko du disque.
Il existe une différence subtile entre les valeurs de retour E_INVALIDARG et VDS_E_NOT_SUPPORTED . Les fournisseurs ne sont pas censés implémenter toutes les fonctionnalités que l’API VDS peut présenter à un client. Par exemple, la méthode CreateLun expose la possibilité de créer de nombreux types de LUN différents (par exemple, simples, miroirs, bandes et parité). Toutefois, les fournisseurs ne sont pas tenus de prendre en charge tous les types de LUN. Si l’appelant spécifie une valeur pour le paramètre de type qui n’est pas une valeur d’énumération VDS_LUN_TYPE valide, le fournisseur doit retourner E_INVALIDARG. Si l’appelant spécifie une valeur de type valide que le fournisseur ne prend pas en charge, le fournisseur doit retourner VDS_E_NOT_SUPPORTED.
Remarques aux implémenteurs : Le fournisseur doit retourner un pointeur d’interface IVdsAsync dans le paramètre ppAsync , même si l’appel à cette méthode n’initie pas d’opération asynchrone.
Configuration requise
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | vdshwprv.h |
| Bibliothèque | Uuid.lib |
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour