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 |