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

A rotina 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 que é passado como o membro Context 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. Os drivers normalmente retornam uma única cadeia de caracteres.

Retornar valor

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

Comentários

A estrutura PNP_LOCATION_INTERFACE fornece um ponteiro para a rotina PnpGetLocationString .

A rotina PnpGetLocationString fornece a parte específica do dispositivo da cadeia de caracteres de localização para o dispositivo. O gerenciador de 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 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 deve 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), em que XX é o número do dispositivo e YY é o número da função.

A rotina 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
Cliente mínimo com suporte	Disponível a partir do Windows Server 2003.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ntddk.h (inclua Ntddk.h, Ntifs.h)
IRQL	<= PASSIVE_LEVEL

Confira também

ExAllocatePoolWithTag

ExFreePool

PNP_LOCATION_INTERFACE