Compartilhar via


PGET_LOCATION_STRING função de retorno de chamada (ntddk.h)

A rotina de PnpGetLocationString fornece a parte específica do dispositivo da propriedade SPDRP_LOCATION_PATHS do dispositivo.

Sintaxe

PGET_LOCATION_STRING PgetLocationString;

NTSTATUS PgetLocationString(
  [in, out] PVOID Context,
  [out]     PZZWSTR *LocationStrings
)
{...}

Parâmetros

[in, out] Context

Um ponteiro para informações de contexto específicas da interface. O chamador passa o valor passado como o Context membro da estrutura PNP_LOCATION_INTERFACE.

[out] LocationStrings

Um ponteiro para uma sequência de cadeias de caracteres Unicode terminadas em nulo, que é encerrada por outro zero. Cada cadeia de caracteres serve como uma cadeia de caracteres de localização para o dispositivo. Normalmente, os drivers retornam uma única cadeia de caracteres.

Valor de retorno

A rotina retorna um valor NTSTATUS para indicar o status da operação.

Observações

A estrutura PNP_LOCATION_INTERFACE fornece um ponteiro para a rotina de PnpGetLocationString.

A rotina de PnpGetLocationString fornece a parte específica do dispositivo da cadeia de caracteres de localização para o dispositivo. O gerenciador do Plug and Play (PnP) monta a cadeia de caracteres de localização de um dispositivo consultando o driver do dispositivo, o barramento do dispositivo e todos os ônibus pai e concatenando as cadeias de caracteres fornecidas juntas.

A rotina deve retornar uma cadeia de caracteres exclusiva para o dispositivo em relação ao seu barramento. A cadeia de caracteres deve ser a mesma para o dispositivo em todas as versões do sistema operacional. Depois de selecionar uma cadeia de caracteres para essa finalidade, você não deverá alterá-la.

Por convenção, a cadeia de caracteres de localização assume o formulário ServiceName(BusSpecificLocation). Por exemplo, os dispositivos PCI usam PCI(XXYY), onde XX é o número do dispositivo e YY é o número da função.

A rotina de PnpGetLocationString chama uma rotina como ExAllocatePoolWithTag para alocar a memória para a cadeia de caracteres de localização. O chamador é responsável por chamar a rotina ExFreePool para liberar a memória apontada por LocationStrings quando a cadeia de caracteres de localização não for mais necessária.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível a partir do Windows Server 2003.
da Plataforma de Destino Área de trabalho
cabeçalho ntddk.h (inclua Ntddk.h, Ntifs.h)
IRQL <= PASSIVE_LEVEL

Consulte também

ExAllocatePoolWithTag

ExFreePool

PNP_LOCATION_INTERFACE