AdvertiseInterface
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função permite que um driver para anunciar quais interfaces ele expõe.
Syntax
BOOL AdvertiseInterface(
const GUID* devclass,
LPCWSTR name,
BOOL fAdd
);
Parameters
- devclass
[no] Ponteiro para um dispositivo interface identificador exclusivo (GUID). Ele não pode ser NULL. Para obter informações sobre a interface dispositivo predefinidos GUIDs, consulte Interface de dispositivo.
- Nome
[no] Nome da instância de interface. Use este nome para identificar esta instância em qualquer modo de interface requer. Esse nome deve ser exclusivo no espaço para nome acessar a interface. Portanto, " DSK2: " pode estar disponível em ambos os o genérico transmitir interface namespace e o espaço para nome interface bloco e irá provavelmente, mas não necessariamente, referir para o mesmo real driver.
- fAdd
[no] Dados para especificar se para adicionar ou remover a interface. Definir como TRUE se a interface foi adicionado. Definir a FALSE se a interface foi removida.
Return Value
TRUE indica sucesso. FALSE indica falha. Razões para falha incluem um GUID que não é exclusivo e o nome, negado permissão, e memória insuficiente para controlar a interface. Ela também falhará se você tentar remover uma interface que nunca tenha sido adicionado.
Remarks
Adicionar uma interface com AdvertiseInterface aloca recursos dentro de Device Manager. Não se esqueça anunciar sua remoção antes que o driver seja descarregado.
Requirements
| Header | winbase.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |