BTHHFP isnt documented either, but I know it's legit RE: FwpsOpenToken0 on WFP

NTDEV
1

Hi Diane;

I worry a little that I might be hijacking this thread, but I would point out that the BTHHFP api’s exist in the public headers but the only documentation for that API is the following whitepaper:

audio-drivers-bluetooth-bypass-guidelines.docx

located at:

http://msdn.microsoft.com/en-us/windows/hardware/br259118

The only reason that I knew this documented existed was due to the fact that the Bluetooth team sent it to me in my previous job as a winrt guy.

It would be helpful if this could get documented in a more traditional (MSDN page) manner. If it is in there I don’t see it when I search for BTHHFP…

Tnx!

johnu

-----Original Message-----
From: xxxxx@lists.osr.com [mailto:xxxxx@lists.osr.com] On Behalf Of Diane Olsen
Sent: Wednesday, February 20, 2013 5:34 PM
To: Windows System Software Devs Interest List
Subject: RE: [ntdev] FwpsOpenToken0 on WFP

It’s OK to ask about functions, structures, etc., that we haven’t documented. If something isn’t documented, that could mean we don’t want anyone to use it. (When that’s the case, we try to say so explicitly in the docs, but our track record is admittedly less than perfect there.) Or it could mean that something fell through the cracks. (It happens, especially in cases where there’s a lot of churn in the DDI after the initial documentation is written.)

In this case, it turns out that we simply forgot to document the function in question. So I’m glad Oleshii asked about it.

I’ll work with the WFP team to create a reference page for FwpsOpenToken0 and report back to NTDEV on it.

-----Original Message-----
From: xxxxx@lists.osr.com [mailto:xxxxx@lists.osr.com] On Behalf Of Tim Roberts
Sent: Wednesday, February 20, 2013 9:27 AM
To: Windows System Software Devs Interest List
Subject: Re: [ntdev] FwpsOpenToken0 on WFP

Oleshii wrote:

I’m again with that community.
New job theme is the W(indows) F(iltering) P(latform).
In the fwpsk.h file declared export

__drv_maxIRQL(PASSIVE_LEVEL) NTSTATUS NTAPI FwpsOpenToken0(IN HANDLE engineHandle,
IN LUID modifiedId, IN DWORD desiredAccess, OUT HANDLE*
accessToken);

MS doesn’t describe this function in MSDN.

Then it is undocumented.

What this function does ?

There is no way to know. It is undocumented.

What does the token is being opened ?

There’s no way to know. It is undocumented.

What is the parameter LUID modifiedId ? Where i can get it ?

Why on earth do you care? If you don’t know what the function is for, what POSSIBLY leads you to think you should use it?

–
Tim Roberts, xxxxx@probo.com
Providenza & Boekelheide, Inc.

NTDEV is sponsored by OSR

OSR is HIRING!! See http://www.osr.com/careers

For our schedule of WDF, WDM, debugging and other seminars visit:
http://www.osr.com/seminars

To unsubscribe, visit the List Server section of OSR Online at http://www.osronline.com/page.cfm?name=ListServer

NTDEV is sponsored by OSR

OSR is HIRING!! See http://www.osr.com/careers

For our schedule of WDF, WDM, debugging and other seminars visit:
http://www.osr.com/seminars

To unsubscribe, visit the List Server section of OSR Online at http://www.osronline.com/page.cfm?name=ListServer

2

Hi John,

Our audio doc writer tells me that the contents of that whitepaper are scheduled to be updated and assimilated into the MSDN Library documentation in June or July of this year. If you don’t see it on MSDN around then, feel free to ping me about it.

Thanks,

–Diane

-----Original Message-----
From: xxxxx@lists.osr.com [mailto:xxxxx@lists.osr.com] On Behalf Of Utz Iii, JohnX L
Sent: Wednesday, February 20, 2013 5:45 PM
To: Windows System Software Devs Interest List
Subject: BTHHFP isnt documented either, but I know it’s legit RE: [ntdev] FwpsOpenToken0 on WFP

Hi Diane;

I worry a little that I might be hijacking this thread, but I would point out that the BTHHFP api’s exist in the public headers but the only documentation for that API is the following whitepaper:

audio-drivers-bluetooth-bypass-guidelines.docx

located at:

http://msdn.microsoft.com/en-us/windows/hardware/br259118

The only reason that I knew this documented existed was due to the fact that the Bluetooth team sent it to me in my previous job as a winrt guy.

It would be helpful if this could get documented in a more traditional (MSDN page) manner. If it is in there I don’t see it when I search for BTHHFP…

Tnx!

johnu

-----Original Message-----
From: xxxxx@lists.osr.com [mailto:xxxxx@lists.osr.com] On Behalf Of Diane Olsen
Sent: Wednesday, February 20, 2013 5:34 PM
To: Windows System Software Devs Interest List
Subject: RE: [ntdev] FwpsOpenToken0 on WFP

It’s OK to ask about functions, structures, etc., that we haven’t documented. If something isn’t documented, that could mean we don’t want anyone to use it. (When that’s the case, we try to say so explicitly in the docs, but our track record is admittedly less than perfect there.) Or it could mean that something fell through the cracks. (It happens, especially in cases where there’s a lot of churn in the DDI after the initial documentation is written.)

In this case, it turns out that we simply forgot to document the function in question. So I’m glad Oleshii asked about it.

I’ll work with the WFP team to create a reference page for FwpsOpenToken0 and report back to NTDEV on it.

-----Original Message-----
From: xxxxx@lists.osr.com [mailto:xxxxx@lists.osr.com] On Behalf Of Tim Roberts
Sent: Wednesday, February 20, 2013 9:27 AM
To: Windows System Software Devs Interest List
Subject: Re: [ntdev] FwpsOpenToken0 on WFP

Oleshii wrote:

I’m again with that community.
New job theme is the W(indows) F(iltering) P(latform).
In the fwpsk.h file declared export

__drv_maxIRQL(PASSIVE_LEVEL) NTSTATUS NTAPI FwpsOpenToken0(IN HANDLE engineHandle,
IN LUID modifiedId, IN DWORD desiredAccess, OUT HANDLE*
accessToken);

MS doesn’t describe this function in MSDN.

Then it is undocumented.

What this function does ?

There is no way to know. It is undocumented.

What does the token is being opened ?

There’s no way to know. It is undocumented.

What is the parameter LUID modifiedId ? Where i can get it ?

Why on earth do you care? If you don’t know what the function is for, what POSSIBLY leads you to think you should use it?

–
Tim Roberts, xxxxx@probo.com
Providenza & Boekelheide, Inc.

NTDEV is sponsored by OSR

OSR is HIRING!! See http://www.osr.com/careers

For our schedule of WDF, WDM, debugging and other seminars visit:
http://www.osr.com/seminars

To unsubscribe, visit the List Server section of OSR Online at http://www.osronline.com/page.cfm?name=ListServer

NTDEV is sponsored by OSR

OSR is HIRING!! See http://www.osr.com/careers

For our schedule of WDF, WDM, debugging and other seminars visit:
http://www.osr.com/seminars

To unsubscribe, visit the List Server section of OSR Online at http://www.osronline.com/page.cfm?name=ListServer

NTDEV is sponsored by OSR

OSR is HIRING!! See http://www.osr.com/careers

For our schedule of WDF, WDM, debugging and other seminars visit:
http://www.osr.com/seminars

To unsubscribe, visit the List Server section of OSR Online at http://www.osronline.com/page.cfm?name=ListServer

3

Hi Diane;

Thankyou so much for the prompt response!

I will be happy to keep an eye out for the MSDN integration in a few months.

That is kind of a long time for me to wait to get my job done tho. :stuck_out_tongue:

That document has a really nice picture in it that unfortunately has some ‘handwaving’ in it that I would like to have clarified. It refers to a ‘standard call control ddi’. What *is* that standard call control ddi? :slight_smile:

Might not be your neighborhood to answer questions like this, I can totally understand that. I know that Frank Yerrace and Rian Chung had a key hand in getting this document out, would you be so kind as to ask them to clarify this detail please?

Tnx!

Johnu

-----Original Message-----
From: xxxxx@lists.osr.com [mailto:xxxxx@lists.osr.com] On Behalf Of Diane Olsen
Sent: Thursday, February 21, 2013 6:36 PM
To: Windows System Software Devs Interest List
Subject: RE: BTHHFP isnt documented either, but I know it’s legit RE: [ntdev] FwpsOpenToken0 on WFP

Hi John,

Our audio doc writer tells me that the contents of that whitepaper are scheduled to be updated and assimilated into the MSDN Library documentation in June or July of this year. If you don’t see it on MSDN around then, feel free to ping me about it.

Thanks,

–Diane

-----Original Message-----
From: xxxxx@lists.osr.com [mailto:xxxxx@lists.osr.com] On Behalf Of Utz Iii, JohnX L
Sent: Wednesday, February 20, 2013 5:45 PM
To: Windows System Software Devs Interest List
Subject: BTHHFP isnt documented either, but I know it’s legit RE: [ntdev] FwpsOpenToken0 on WFP

Hi Diane;

I worry a little that I might be hijacking this thread, but I would point out that the BTHHFP api’s exist in the public headers but the only documentation for that API is the following whitepaper:

audio-drivers-bluetooth-bypass-guidelines.docx

located at:

http://msdn.microsoft.com/en-us/windows/hardware/br259118

The only reason that I knew this documented existed was due to the fact that the Bluetooth team sent it to me in my previous job as a winrt guy.

It would be helpful if this could get documented in a more traditional (MSDN page) manner. If it is in there I don’t see it when I search for BTHHFP…

Tnx!

johnu

-----Original Message-----
From: xxxxx@lists.osr.com [mailto:xxxxx@lists.osr.com] On Behalf Of Diane Olsen
Sent: Wednesday, February 20, 2013 5:34 PM
To: Windows System Software Devs Interest List
Subject: RE: [ntdev] FwpsOpenToken0 on WFP

It’s OK to ask about functions, structures, etc., that we haven’t documented. If something isn’t documented, that could mean we don’t want anyone to use it. (When that’s the case, we try to say so explicitly in the docs, but our track record is admittedly less than perfect there.) Or it could mean that something fell through the cracks. (It happens, especially in cases where there’s a lot of churn in the DDI after the initial documentation is written.)

In this case, it turns out that we simply forgot to document the function in question. So I’m glad Oleshii asked about it.

I’ll work with the WFP team to create a reference page for FwpsOpenToken0 and report back to NTDEV on it.

-----Original Message-----
From: xxxxx@lists.osr.com [mailto:xxxxx@lists.osr.com] On Behalf Of Tim Roberts
Sent: Wednesday, February 20, 2013 9:27 AM
To: Windows System Software Devs Interest List
Subject: Re: [ntdev] FwpsOpenToken0 on WFP

Oleshii wrote:

I’m again with that community.
New job theme is the W(indows) F(iltering) P(latform).
In the fwpsk.h file declared export

__drv_maxIRQL(PASSIVE_LEVEL) NTSTATUS NTAPI FwpsOpenToken0(IN HANDLE engineHandle,
IN LUID modifiedId, IN DWORD desiredAccess, OUT HANDLE*
accessToken);

MS doesn’t describe this function in MSDN.

Then it is undocumented.

What this function does ?

There is no way to know. It is undocumented.

What does the token is being opened ?

There’s no way to know. It is undocumented.

What is the parameter LUID modifiedId ? Where i can get it ?

Why on earth do you care? If you don’t know what the function is for, what POSSIBLY leads you to think you should use it?

–
Tim Roberts, xxxxx@probo.com
Providenza & Boekelheide, Inc.

NTDEV is sponsored by OSR

OSR is HIRING!! See http://www.osr.com/careers

For our schedule of WDF, WDM, debugging and other seminars visit:
http://www.osr.com/seminars

To unsubscribe, visit the List Server section of OSR Online at http://www.osronline.com/page.cfm?name=ListServer

NTDEV is sponsored by OSR

OSR is HIRING!! See http://www.osr.com/careers

For our schedule of WDF, WDM, debugging and other seminars visit:
http://www.osr.com/seminars

To unsubscribe, visit the List Server section of OSR Online at http://www.osronline.com/page.cfm?name=ListServer

NTDEV is sponsored by OSR

OSR is HIRING!! See http://www.osr.com/careers

For our schedule of WDF, WDM, debugging and other seminars visit:
http://www.osr.com/seminars

To unsubscribe, visit the List Server section of OSR Online at http://www.osronline.com/page.cfm?name=ListServer

NTDEV is sponsored by OSR

OSR is HIRING!! See http://www.osr.com/careers

For our schedule of WDF, WDM, debugging and other seminars visit:
http://www.osr.com/seminars

To unsubscribe, visit the List Server section of OSR Online at http://www.osronline.com/page.cfm?name=ListServer