Función IoWMIAllocateInstanceIds (wdm.h)

La rutina IoWMIAllocateInstanceIds asigna uno o varios identificadores de instancia que son únicos para el GUID.

Sintaxis

NTSTATUS IoWMIAllocateInstanceIds(
  [in]  LPCGUID Guid,
  [in]  ULONG   InstanceCount,
  [out] ULONG   *FirstInstanceId
);

Parámetros

[in] Guid

Puntero al GUID para el que se van a generar identificadores de instancia.

[in] InstanceCount

Especifica cuántos identificadores de instancia se deben proporcionar.

[out] FirstInstanceId

Puntero al identificador de primera instancia que debe usar el controlador.

Valor devuelto

IoWMIAllocateInstanceIds devuelve un código de estado de la lista siguiente:

Código devuelto Descripción
STATUS_SUCCESS
Indica que WMI proporcionó correctamente identificadores de instancia únicos para el GUID especificado.
STATUS_UNSUCCESSFUL
Indica que los servicios WMI no están disponibles.
STATUS_INSUFFICIENT_RESOURCES
Indica que los recursos insuficientes estaban disponibles para proporcionar al autor de la llamada identificadores de instancia.

Comentarios

Si se solicitó más de una instancia en InstanceCount y la rutina se completó correctamente, FirstInstanceId apunta a la primera instancia que debe usar el autor de la llamada. Para cada instancia solicitada más allá de una, el autor de la llamada debe incrementar el valor devuelto en *FirstInstanceId. Por ejemplo, si el autor de la llamada solicitó seis instancias y una se devolvió como el valor de FirstInstanceId, el autor de la llamada debe usar los valores 1-6 como identificadores de instancia únicos.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 2000.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

Consulte también

IoWmiSuggestInstanceName